nttp 1.4.6 → 1.4.9

package/README.md

@@ -10,6 +10,8 @@ npm install nttp
 
 ## Quick Start with CLI (Recommended)
 
+### For Humans: Interactive Setup
+
 The easiest way to get started is with our **interactive setup wizard** (powered by [Ink](https://github.com/vadimdemedes/ink) for a beautiful CLI experience):
 
 ```bash
@@ -23,12 +25,62 @@ This will:
 - ✅ Create your `.env` file
 - ✅ Generate example code
 
-Then query your database:
+### For LLM Agents: Non-Interactive Setup
+
+Perfect for automation, CI/CD, or LLM agents:
+
+```bash
+npx nttp setup --non-interactive \
+  --database-type=pg \
+  --database-url=postgresql://user:pass@localhost:5432/db \
+  --llm-provider=anthropic \
+  --llm-api-key=sk-ant-... \
+  --redis-url=redis://localhost:6379 \
+  --enable-l2-cache \
+  --embedding-api-key=sk-...
+```
+
+**Minimal example (SQLite + Claude):**
+```bash
+npx nttp setup --non-interactive \
+  --database-type=better-sqlite3 \
+  --database-path=./data.db \
+  --llm-provider=anthropic \
+  --llm-api-key=sk-ant-...
+```
+
+**All available flags:**
+- `--database-type` - Required: `pg`, `mysql2`, `better-sqlite3`, `mssql`
+- `--database-url` - Required (except for SQLite): Connection URL
+- `--database-path` - Required for SQLite: Path to .db file
+- `--llm-provider` - Required: `anthropic`, `openai`, `cohere`, `mistral`, `google`
+- `--llm-model` - Optional: Model name (auto-selected if omitted)
+- `--llm-api-key` - Required: API key for LLM provider
+- `--redis-url` - Optional: Redis URL for L1 cache persistence
+- `--enable-l2-cache` - Optional: Enable semantic caching
+- `--embedding-api-key` - Required if L2 enabled: OpenAI API key
+
+### Query Your Database
 
 ```bash
 npx nttp query "show me 5 users"
 ```
 
+### Get Documentation (Great for LLM Agents)
+
+```bash
+# Show all documentation
+npx nttp docs
+
+# Search documentation
+npx nttp docs redis
+npx nttp docs "cache configuration"
+npx nttp docs setup
+npx nttp docs --query "semantic cache"
+```
+
+Returns relevant sections instantly - perfect for agents to quickly find information!
+
 Or use in your code:
 
 ```typescript
@@ -300,6 +352,8 @@ Beautiful interactive setup wizard (powered by Ink) with Vercel-inspired DX:
 - Creates `.env` file
 - Generates example code
 
+For non-interactive setup (agents/automation), see the section above.
+
 ### `npx nttp init`
 
 Alias for `npx nttp setup`. Quick project initialization.
@@ -317,6 +371,36 @@ npx nttp query "top 10 customers by revenue" --format json
 Options:
 - `--format <type>` - Output format: `table` (default) or `json`
 
+### `npx nttp docs [query]`
+
+Show documentation or search for specific topics (perfect for LLM agents):
+
+```bash
+# Show all documentation
+npx nttp docs
+
+# Search for specific topics
+npx nttp docs redis              # Find Redis-related docs
+npx nttp docs cache              # Find cache documentation
+npx nttp docs setup              # Find setup instructions
+npx nttp docs "l2 semantic"      # Multi-word search
+npx nttp docs --query "api key"  # Alternative syntax
+```
+
+**Searchable Topics:**
+- `setup` - Setup command and configuration
+- `cache` - 3-layer cache system (L1, L2, L3)
+- `redis` - Redis persistence configuration
+- `query` - Query command and examples
+- `api` - Programmatic API usage
+- `databases` - Supported databases
+- `llm` - LLM providers and models
+- `performance` - Performance metrics and optimization
+- `troubleshooting` - Common issues and solutions
+- `examples` - Example natural language queries
+
+**Agent-Friendly Output:** Returns only relevant sections with context, making it easy for LLM agents to quickly find information without parsing full documentation files.
+
 ## Error Handling
 
 ```typescript

package/dist/cli/docs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Documentation command for LLM agents
+ */
+interface DocsOptions {
+    query?: string;
+}
+export declare function runDocs(query?: string, options?: DocsOptions): void;
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/cli/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgYH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAsEvE"}

package/dist/cli/docs.js

@@ -0,0 +1,437 @@
+/**
+ * Documentation command for LLM agents
+ */
+const DOCS = {
+    overview: `
+# NTTP Documentation
+
+Natural Text Transfer Protocol - Query databases with natural language.
+
+## Quick Start
+
+### Interactive Setup (for humans):
+  npx nttp setup
+
+### Non-Interactive Setup (for agents):
+  npx nttp setup --non-interactive \\
+    --database-type=pg \\
+    --database-url=postgresql://... \\
+    --llm-provider=anthropic \\
+    --llm-api-key=sk-ant-...
+
+### Query Database:
+  npx nttp query "show me 5 users"
+
+---
+`,
+    setup: `
+## Setup Command
+
+### Interactive Mode:
+  npx nttp setup
+
+  Guides you through configuration with beautiful UI.
+
+### Non-Interactive Mode (for agents/automation):
+  npx nttp setup --non-interactive [options]
+
+  Required Options:
+    --database-type <type>      pg, mysql2, better-sqlite3, mssql
+    --database-url <url>        Connection URL (not for SQLite)
+    --database-path <path>      SQLite database path
+    --llm-provider <provider>   anthropic, openai, cohere, mistral, google
+    --llm-api-key <key>         API key for LLM provider
+
+  Optional Options:
+    --llm-model <model>         Model name (auto-selected if omitted)
+    --redis-url <url>           Redis URL for L1 cache persistence
+    --enable-l2-cache           Enable semantic caching
+    --embedding-api-key <key>   OpenAI API key (required if --enable-l2-cache)
+
+  Example:
+    npx nttp setup --non-interactive \\
+      --database-type=pg \\
+      --database-url=postgresql://user:pass@localhost:5432/db \\
+      --llm-provider=anthropic \\
+      --llm-api-key=sk-ant-...
+
+---
+`,
+    cache: `
+## Cache System
+
+NTTP uses a 3-layer cache for cost optimization:
+
+### L1: Exact Match Cache
+  - Type: Hash-based lookup
+  - Storage: In-memory (default) or Redis (persistent)
+  - Cost: $0
+  - Latency: <1ms (in-memory) or ~5ms (Redis)
+  - Use: Identical queries
+
+### L2: Semantic Match Cache
+  - Type: Embedding-based similarity
+  - Storage: In-memory
+  - Cost: ~$0.0001 per query
+  - Latency: 50-100ms
+  - Use: Similar phrasing (e.g., "get users" vs "show users")
+  - Threshold: 0.85 similarity (configurable)
+
+### L3: LLM Generation
+  - Type: Full intent parsing + SQL generation
+  - Provider: Claude, GPT-4, etc.
+  - Cost: ~$0.01 per query
+  - Latency: 2-3s
+  - Use: Novel queries
+
+### Cache Persistence with Redis
+
+Enable Redis for L1 cache to persist across CLI invocations:
+
+Environment Variable:
+  REDIS_URL=redis://localhost:6379
+
+Non-Interactive Setup:
+  npx nttp setup --non-interactive \\
+    --redis-url=redis://localhost:6379 \\
+    [other options...]
+
+Configuration (programmatic):
+  const nttp = new NTTP({
+    cache: {
+      redis: {
+        url: 'redis://localhost:6379'
+      }
+    }
+  });
+
+Benefits:
+  - Cache persists across CLI invocations
+  - Shared cache in multi-instance deployments
+  - Reduced cold-start latency
+  - 24-hour TTL for cached entries
+
+---
+`,
+    query: `
+## Query Command
+
+Execute natural language queries:
+
+  npx nttp query "your question here"
+
+Options:
+  -f, --format <type>   Output format: table (default) or json
+
+Examples:
+  npx nttp query "show me 5 users"
+  npx nttp query "count active orders"
+  npx nttp query "top 10 products by price" --format json
+
+Query Patterns:
+  - Simple: "show me users"
+  - Filtered: "active users from California"
+  - Sorted: "top 10 products by price"
+  - Aggregated: "count orders by status"
+  - Complex: "users who joined this year with orders"
+
+Output:
+  - SQL: Generated SQL query
+  - Cache: HIT or MISS (which layer)
+  - Data: Query results
+  - Time: Execution time in ms
+
+---
+`,
+    api: `
+## Programmatic API
+
+### From Environment (.env)
+
+  import { NTTP } from 'nttp';
+
+  const nttp = await NTTP.fromEnv();
+  const result = await nttp.query("show me users");
+  await nttp.close();
+
+Requires .env file:
+  DATABASE_URL=postgresql://...
+  DATABASE_TYPE=pg
+  LLM_PROVIDER=anthropic
+  LLM_MODEL=claude-sonnet-4-5-20250929
+  ANTHROPIC_API_KEY=sk-ant-...
+  REDIS_URL=redis://localhost:6379  # Optional
+
+### Manual Configuration
+
+  import { NTTP } from 'nttp';
+
+  const nttp = new NTTP({
+    database: {
+      client: 'pg',
+      connection: process.env.DATABASE_URL
+    },
+    llm: {
+      provider: 'anthropic',
+      model: 'claude-sonnet-4-5-20250929',
+      apiKey: process.env.ANTHROPIC_API_KEY
+    },
+    cache: {
+      redis: {
+        url: 'redis://localhost:6379'
+      },
+      l2: {
+        provider: 'openai',
+        model: 'text-embedding-3-small',
+        apiKey: process.env.OPENAI_API_KEY
+      }
+    }
+  });
+
+  await nttp.init();
+  const result = await nttp.query("your question");
+  await nttp.close();
+
+### Query Result
+
+  {
+    query: string,           // Original natural language query
+    data: any[],            // Query results
+    sql: string,            // Generated SQL
+    params: any[],          // SQL parameters
+    schemaId: string,       // Cache key
+    cacheHit: boolean,      // Was query cached?
+    executionTimeMs: number, // Execution time
+    intent: Intent,         // Parsed intent
+    meta?: {                // Cache metadata
+      cacheLayer: 1 | 2 | 3,
+      cost: number,
+      latency: number,
+      similarity?: number   // For L2 hits
+    }
+  }
+
+---
+`,
+    databases: `
+## Supported Databases
+
+### PostgreSQL
+  Type: pg
+  Connection: postgresql://user:pass@host:port/database
+  Recommended for: Production
+
+### MySQL
+  Type: mysql2
+  Connection: mysql://user:pass@host:port/database
+  Recommended for: Web applications
+
+### SQLite
+  Type: better-sqlite3
+  Connection: Path to .db file
+  Recommended for: Development, testing
+
+### SQL Server
+  Type: mssql
+  Connection: Server=host;Database=db;User Id=user;Password=pass
+  Recommended for: Enterprise applications
+
+---
+`,
+    llm: `
+## LLM Providers
+
+### Anthropic (Claude)
+  Provider: anthropic
+  Models: claude-sonnet-4-5-20250929, claude-opus-4-5, claude-haiku-4
+  API Key: ANTHROPIC_API_KEY
+  Best for: Highest quality SQL generation
+
+### OpenAI (GPT)
+  Provider: openai
+  Models: gpt-4o, gpt-4-turbo, gpt-3.5-turbo
+  API Key: OPENAI_API_KEY
+  Best for: Fast and reliable
+
+### Cohere
+  Provider: cohere
+  Models: command-r-plus, command-r
+  API Key: COHERE_API_KEY
+  Best for: Enterprise deployments
+
+### Mistral
+  Provider: mistral
+  Models: mistral-large-latest, mistral-medium
+  API Key: MISTRAL_API_KEY
+  Best for: Open-source preference
+
+### Google (Gemini)
+  Provider: google
+  Models: gemini-pro, gemini-ultra
+  API Key: GOOGLE_API_KEY
+  Best for: Multimodal capabilities
+
+---
+`,
+    performance: `
+## Performance Metrics
+
+### Cache Performance
+  L1 (In-Memory): <1ms latency, $0 cost
+  L1 (Redis):     ~5ms latency, $0 cost
+  L2 (Semantic):  50-100ms latency, ~$0.0001 cost
+  L3 (LLM):       2-3s latency, ~$0.01 cost
+
+### Cost Savings
+  Without caching: 1000 queries × $0.01 = $10.00
+  With caching:    ~$1.00 (90% savings after warmup)
+
+### Hit Rates (typical after warmup)
+  L1: 60-70% of queries
+  L2: 20-30% of queries
+  L3: 5-10% of queries
+
+### Throughput
+  Cached queries: >10,000 req/s
+  LLM queries:    Limited by API rate limits
+
+---
+`,
+    troubleshooting: `
+## Troubleshooting
+
+### Setup Issues
+
+Q: "Cannot find package 'nttp'"
+A: Run: npm install nttp dotenv
+
+Q: "Cannot find package 'dotenv'"
+A: Run: npm install dotenv
+
+Q: Setup fails to install dependencies
+A: Manually run: npm install nttp dotenv
+
+### Query Issues
+
+Q: Query returns empty results
+A: Check database connection and schema
+   Verify query makes sense for your data
+
+Q: "SQL generation failed"
+A: Check LLM API key is valid
+   Ensure LLM provider is correctly configured
+   Try simpler query first
+
+Q: Cache always shows MISS
+A: First query is always MISS (populates cache)
+   Check Redis connection if using Redis
+   Verify REDIS_URL is correct
+
+### Connection Issues
+
+Q: "Database connection failed"
+A: Verify DATABASE_URL is correct
+   Check database server is running
+   Confirm network access to database
+
+Q: "Redis connection failed"
+A: Verify Redis server is running
+   Check REDIS_URL format: redis://host:port
+   Confirm network access to Redis
+
+---
+`,
+    examples: `
+## Example Queries
+
+### Simple Queries
+  "show me all users"
+  "get all products"
+  "list recent orders"
+
+### Filtered Queries
+  "active users from California"
+  "products under $50"
+  "orders from last 30 days"
+  "pending orders"
+
+### Sorting and Limits
+  "top 10 most expensive products"
+  "newest 20 users"
+  "5 most recent orders"
+
+### Aggregations
+  "count users by status"
+  "total revenue by category"
+  "average order value"
+
+### Complex Queries
+  "show users with their order count"
+  "products with average rating above 4"
+  "top customers by total spent"
+
+---
+`,
+};
+export function runDocs(query, options = {}) {
+    const searchQuery = query || options.query;
+    if (!searchQuery) {
+        // Show all documentation
+        console.log('📚 NTTP Documentation\n');
+        console.log('='.repeat(60));
+        Object.values(DOCS).forEach(section => {
+            console.log(section);
+        });
+        console.log('='.repeat(60));
+        console.log('\nSearch docs: npx nttp docs <query>');
+        console.log('Examples:');
+        console.log('  npx nttp docs redis');
+        console.log('  npx nttp docs "cache configuration"');
+        console.log('  npx nttp docs setup');
+        return;
+    }
+    // Search/grep through documentation
+    const searchTerm = searchQuery.toLowerCase();
+    const results = [];
+    Object.entries(DOCS).forEach(([section, content]) => {
+        const lines = content.split('\n');
+        const matchingLines = [];
+        lines.forEach((line, index) => {
+            if (line.toLowerCase().includes(searchTerm)) {
+                // Include context: 2 lines before and after
+                const start = Math.max(0, index - 2);
+                const end = Math.min(lines.length, index + 3);
+                const context = lines.slice(start, end).join('\n');
+                matchingLines.push(context);
+            }
+        });
+        if (matchingLines.length > 0) {
+            results.push({
+                section,
+                content,
+                matches: matchingLines,
+            });
+        }
+    });
+    if (results.length === 0) {
+        console.log(`❌ No results found for: "${searchQuery}"\n`);
+        console.log('💡 Try searching for:');
+        console.log('  - setup, query, cache, redis, database, llm, api, examples');
+        return;
+    }
+    console.log(`🔍 Search results for: "${searchQuery}"\n`);
+    console.log('='.repeat(60));
+    results.forEach(({ section, matches }) => {
+        console.log(`\n## ${section.toUpperCase()}\n`);
+        // Show unique matches (deduplicate overlapping contexts)
+        const uniqueMatches = [...new Set(matches)];
+        uniqueMatches.forEach(match => {
+            console.log(match);
+            console.log('---');
+        });
+    });
+    console.log('='.repeat(60));
+    console.log(`\nFound ${results.length} section(s) with "${searchQuery}"`);
+    console.log('\nShow all docs: npx nttp docs');
+}
+//# sourceMappingURL=docs.js.map

package/dist/cli/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/cli/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,IAAI,GAAG;IACX,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBX;IAEC,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCR;IAEC,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDR;IAEC,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BR;IAEC,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqEN;IAEC,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBZ;IAEC,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCN;IAEC,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBd;IAEC,eAAe,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ClB;IAEC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BX;CACA,CAAC;AAMF,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,UAAuB,EAAE;IAC/D,MAAM,WAAW,GAAG,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAE3C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACpC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAmE,EAAE,CAAC;IAEnF,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE;QAClD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,aAAa,GAAa,EAAE,CAAC;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5C,4CAA4C;gBAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnD,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO;gBACP,OAAO;gBACP,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,4BAA4B,WAAW,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,WAAW,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE;QACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAE/C,yDAAyD;QACzD,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,CAAC,MAAM,qBAAqB,WAAW,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;AAChD,CAAC"}

package/dist/cli/setup-ink.d.ts

@@ -1,5 +1,18 @@
 /**
- * Setup command using Ink
+ * Setup using Ink (interactive) or CLI (non-interactive)
  */
-export declare function runSetup(): Promise<void>;
+interface SetupOptions {
+    nonInteractive?: boolean;
+    databaseType?: string;
+    databaseUrl?: string;
+    databasePath?: string;
+    llmProvider?: string;
+    llmModel?: string;
+    llmApiKey?: string;
+    redisUrl?: string;
+    enableL2Cache?: boolean;
+    embeddingApiKey?: string;
+}
+export declare function runSetup(options?: SetupOptions): Promise<void>;
+export {};
 //# sourceMappingURL=setup-ink.d.ts.map

package/dist/cli/setup-ink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-ink.d.ts","sourceRoot":"","sources":["../../src/cli/setup-ink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9C"}
+{"version":3,"file":"setup-ink.d.ts","sourceRoot":"","sources":["../../src/cli/setup-ink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,UAAU,YAAY;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,QAAQ,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE"}

package/dist/cli/setup-ink.js

@@ -1,10 +1,28 @@
 /**
- * Setup command using Ink
+ * Setup using Ink (interactive) or CLI (non-interactive)
  */
 import React from 'react';
 import { render } from 'ink';
 import SetupWizard from './SetupWizard.js';
-export async function runSetup() {
-    render(React.createElement(SetupWizard));
+import { runNonInteractiveSetup } from './setup-non-interactive.js';
+export async function runSetup(options = {}) {
+    // Check if running in non-interactive mode
+    if (options.nonInteractive) {
+        runNonInteractiveSetup({
+            databaseType: options.databaseType,
+            databaseUrl: options.databaseUrl,
+            databasePath: options.databasePath,
+            llmProvider: options.llmProvider,
+            llmModel: options.llmModel,
+            llmApiKey: options.llmApiKey,
+            redisUrl: options.redisUrl,
+            enableL2Cache: options.enableL2Cache,
+            embeddingApiKey: options.embeddingApiKey,
+        });
+    }
+    else {
+        // Run interactive Ink wizard
+        render(React.createElement(SetupWizard));
+    }
 }
 //# sourceMappingURL=setup-ink.js.map

package/dist/cli/setup-ink.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-ink.js","sourceRoot":"","sources":["../../src/cli/setup-ink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"setup-ink.js","sourceRoot":"","sources":["../../src/cli/setup-ink.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,WAAW,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAepE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,UAAwB,EAAE;IACvD,2CAA2C;IAC3C,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,sBAAsB,CAAC;YACrB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,6BAA6B;QAC7B,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/cli/setup-non-interactive.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Non-interactive setup for LLM agents and automation
+ */
+interface NonInteractiveConfig {
+    databaseType?: string;
+    databaseUrl?: string;
+    databasePath?: string;
+    llmProvider?: string;
+    llmModel?: string;
+    llmApiKey?: string;
+    redisUrl?: string;
+    enableL2Cache?: boolean;
+    embeddingApiKey?: string;
+}
+export declare function runNonInteractiveSetup(options: NonInteractiveConfig): void;
+export {};
+//# sourceMappingURL=setup-non-interactive.d.ts.map

package/dist/cli/setup-non-interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-non-interactive.d.ts","sourceRoot":"","sources":["../../src/cli/setup-non-interactive.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,UAAU,oBAAoB;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CA2K1E"}

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.9');
 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,OAAO,CAAC,CAAC;AAEpB,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nttp",
-  "version": "1.4.6",
+  "version": "1.4.9",
   "description": "natural text to query - Query databases with natural language",
   "type": "module",
   "main": "./dist/index.js",