nl2sql-engine 0.1.0__py3-none-any.whl

nl2sql_engine-0.1.0.dist-info/METADATA

@@ -0,0 +1,295 @@
+Metadata-Version: 2.4
+Name: nl2sql-engine
+Version: 0.1.0
+Summary: Natural-language-to-SQL engine, CLI and database adapters
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: SQLAlchemy>=2.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: langgraph<2,>=1.2
+Requires-Dist: langchain>=0.2.0
+Requires-Dist: langchain-core<2,>=1.6
+Requires-Dist: langchain-chroma<2,>=1.1
+Requires-Dist: langchain-openai<2,>=1.6
+Requires-Dist: chromadb<2,>=1.5
+Requires-Dist: nl2sql-adapter-sdk~=0.1
+Requires-Dist: pydantic>=2.0
+Requires-Dist: opentelemetry-api>=1.20.0
+Requires-Dist: opentelemetry-sdk>=1.20.0
+Requires-Dist: opentelemetry-exporter-otlp>=1.20.0
+Requires-Dist: sqlglot>=23.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: pyarrow>=14.0.0
+Requires-Dist: pybreaker>=1.3.0
+Requires-Dist: polars>=1.44
+Requires-Dist: duckdb>=1.5
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: inquirerpy>=0.3.4
+Provides-Extra: aws
+Requires-Dist: boto3; extra == "aws"
+Provides-Extra: azure
+Requires-Dist: azure-identity; extra == "azure"
+Requires-Dist: azure-keyvault-secrets; extra == "azure"
+Provides-Extra: duckdb
+Requires-Dist: duckdb; extra == "duckdb"
+Requires-Dist: duckdb-engine; extra == "duckdb"
+Provides-Extra: hashicorp
+Requires-Dist: hvac; extra == "hashicorp"
+Provides-Extra: mssql
+Requires-Dist: pyodbc>=4.0.0; extra == "mssql"
+Requires-Dist: pymssql>=2.2.0; platform_system == "Linux" and extra == "mssql"
+Provides-Extra: mysql
+Requires-Dist: pymysql>=1.1.0; extra == "mysql"
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary>=2.9; extra == "postgres"
+Provides-Extra: all
+Requires-Dist: duckdb; extra == "all"
+Requires-Dist: duckdb-engine; extra == "all"
+Requires-Dist: pyodbc>=4.0.0; extra == "all"
+Requires-Dist: pymssql>=2.2.0; platform_system == "Linux" and extra == "all"
+Requires-Dist: pymysql>=1.1.0; extra == "all"
+Requires-Dist: psycopg2-binary>=2.9; extra == "all"
+
+# NL2SQL
+
+The **`nl2sql`** package is the brain of the natural language to SQL engine. It orchestrates the entire query lifecycle using a graph-based agent architecture, and also ships the `nl2sql` CLI (`nl2sql.cli`) and the four database adapters (`nl2sql.adapters.*`).
+
+## 🏗️ Architecture Overview
+
+The NL2SQL Core is built around a **graph-based orchestration system** using LangGraph that treats text-to-SQL as a distributed systems problem. The architecture is organized around several key planes:
+
+### 1. **The Control Plane (The Graph)**
+- **Responsibility**: Reasoning, Planning, and Orchestration
+- **Implementation**: Directed Cyclic Graph (LangGraph) with explicit state (`GraphState`)
+- **Features**: Agentic graph with refinement loops for self-correction when plans fail validation
+
+### 2. **The Security Plane (The Firewall)**
+- **Responsibility**: Invariants Enforcement
+- **Implementation**: Valid-by-Construction approach where LLM generates Abstract Syntax Tree (AST) rather than executing SQL
+- **Features**: Static analysis through logical validators enforcing RBAC and schema constraints
+
+### 3. **The Data Plane (The Sandbox)**
+- **Responsibility**: Semantic Search and Execution
+- **Implementation**: Sandboxed Process Pool for SQL driver isolation
+- **Features**: Partitioned retrieval with schema store and vector-based context injection
+
+### 4. **The Reliability Plane (The Guard)**
+- **Responsibility**: Fault Tolerance and Stability
+- **Implementation**: Layered defense with Circuit Breakers and Sandboxing
+- **Features**: Fail-fast approach with strict timeouts preventing cascading failures
+
+### 5. **The Observability Plane (The Watchtower)**
+- **Responsibility**: Visibility, Forensics, and Compliance
+- **Implementation**: Native OpenTelemetry integration
+- **Features**: Distributed tracing (Jaeger), metrics (Prometheus), and forensic audit logs
+
+## 🧠 Key Components
+
+### **Context Management (`context.py`)**
+- `NL2SQLContext`: Centralized application context managing initialization lifecycle
+- Ensures proper ordering: secrets → datasources → LLMs → policies
+- Coordinates all registries and stores
+
+### **Graph Pipeline (`pipeline/`)**
+- **Graph Orchestration**: LangGraph-based state machine managing query flow
+- **Nodes**: DatasourceResolver, Decomposer, GlobalPlanner, Aggregator, AnswerSynthesizer
+- **Subgraphs**: SQL Agent subgraph with AST planner, validators, and executor
+- **State Management**: Shared `GraphState` for auditability and reproducibility
+
+### **Schema Management (`schema/`)**
+- **Schema Store**: Persistent storage for schema snapshots with versioning
+- **Schema Contracts**: Typed representations of database schemas
+- **Versioning**: Multiple schema versions with eviction policies
+
+### **Indexing System (`indexing/`)**
+- **Schema Indexing**: Vector-based indexing of schema information
+- **Chunk Builder**: Breaks schema into searchable chunks
+- **Enrichment Service**: Enhances schema with example questions
+
+### **Data Sources (`datasources/`)**
+- **Registry**: Dynamic registration and management of database adapters
+- **Protocols**: Standardized interfaces for database connectivity
+- **Discovery**: Automatic discovery of available adapter types
+
+### **LLM Management (`llm/`)**
+- **Registry**: Management of multiple LLM instances
+- **Configuration**: Flexible LLM provider configuration (OpenAI, etc.)
+- **Routing**: Intelligent routing to appropriate LLMs
+
+### **Authentication & Authorization (`auth/`)**
+- **RBAC**: Role-based access control for data access
+- **User Context**: Identity and permission context propagation
+- **Policy Engine**: Fine-grained access control rules
+
+## 🚀 Public API
+
+The main public interface is provided through the `NL2SQL` class:
+
+```python
+from nl2sql import NL2SQL
+
+# Initialize the engine
+engine = NL2SQL(
+    ds_config_path="configs/datasources.yaml",
+    llm_config_path="configs/llm.yaml",
+    policies_path="configs/policies.json"
+)
+
+# Run a natural language query
+result = engine.run_query("Show top 10 customers by revenue")
+print(result.final_answer)
+```
+
+### Two-Tier API Architecture
+
+NL2SQL provides a two-tier API architecture:
+
+#### 1. Core API (Python) - This Package
+- **Interface**: Direct Python class interface (`NL2SQL` class)
+- **Use Case**: Direct Python integration, embedded applications
+- **Access**: Import and use directly in Python code
+
+#### 2. REST API (HTTP)
+- **Package**: API package (`nl2sql-api`)
+- **Interface**: HTTP REST endpoints
+- **Use Case**: Remote clients, web applications, TypeScript CLI
+- **Access**: HTTP requests to API endpoints
+
+Both APIs provide access to the same underlying NL2SQL engine functionality, allowing flexible integration options.
+
+### Modular API Structure
+
+The engine provides modular APIs for different functionality areas:
+
+- `engine.query` - Query execution API (`run_query`, etc.)
+- `engine.datasource` - Datasource management API (`add_datasource`, `list_datasources`, etc.)
+- `engine.llm` - LLM configuration API (`configure_llm`, etc.)
+- `engine.indexing` - Schema indexing API (`index_datasource`, `clear_index`, etc.)
+- `engine.auth` - Authentication and RBAC API (`check_permissions`, `get_allowed_resources`, etc.)
+- `engine.settings` - Configuration and settings API (`get_current_settings`, `validate_configuration`, etc.)
+- `engine.results` - Result management API (`store_query_result`, `retrieve_query_result`, etc.)
+- `engine.policy` - Policy validation API (`validate_policies`, etc.)
+- `engine.benchmark` - Benchmarking API (`run_matrix`, etc.)
+
+For complete Core API documentation, see `docs/api/core.md` in this repo
+or the API section of the published MkDocs site.
+
+## 📋 Public API Classes
+
+The public API exports the following classes and types:
+
+- `NL2SQL` - Main engine class
+- `QueryResult` - Query result container
+- `UserContext` - User authentication context
+- `ErrorSeverity`, `ErrorCode`, `PipelineError` - Error handling types
+- `QueryAPI`, `DatasourceAPI`, `LLM_API`, `IndexingAPI`, `AuthAPI`, `SettingsAPI`, `ResultAPI`, `PolicyAPI`, `BenchmarkAPI` - Modular API classes
+- `BenchmarkConfig` - Benchmark configuration model
+
+## 📦 Installation
+
+```bash
+# Engine, CLI and adapters; sqlite works out of the box
+pip install nl2sql-engine
+
+# Add the drivers for selected dialects
+pip install "nl2sql-engine[mysql,mssql]"
+
+# Add every database driver
+pip install "nl2sql-engine[all]"
+```
+
+## 🔖 Versioning Policy
+
+The three distributions in this monorepo -- `nl2sql-adapter-sdk`, `nl2sql-engine` and
+`nl2sql-api` -- share a single version number and are released together. They
+pin internal dependencies to the same version to prevent mismatches.
+
+## 🚀 Usage (CLI)
+
+The core package exposes the CLI entry point:
+
+```bash
+python -m nl2sql.cli --query "Show me all users" --id my_postgres_db
+```
+
+## 🛡️ Architectural Invariants
+
+| Invariant | Rationale | Mechanism |
+| :--- | :--- | :--- |
+| **No Unvalidated SQL** | Prevent hallucinations & data leaks | All plans pass through `LogicalValidator` (AST). |
+| **Zero Shared State** | Crash Safety | Execution happens in isolated processes; no shared memory with the Control Plane. |
+| **Fail-Fast** | Reliability | Circuit Breakers and Strict Timeouts prevent cascading failures (Retry Storms). |
+| **Determinism** | Debuggability | Temperature-0 generation + Strict Typing (Pydantic) for all LLM outputs. |
+
+## 🏗️ Pipeline Flow
+
+The main execution flow follows this sequence:
+
+1. **Datasource Resolver** → **Decomposer** → **Global Planner** → **Layer Router**
+2. **SQL Agent Subgraph**: Schema Retriever → AST Planner → Logical Validator → Generator → Executor
+3. **Self-correction loops**: When validation fails, the system refines and retries
+
+### SQL Agent Subgraph Details:
+- **AST Planner**: Generates Abstract Syntax Tree instead of direct SQL
+- **Logical Validator**: Enforces RBAC and schema constraints
+- **Generator**: Converts AST to dialect-specific SQL
+- **Executor**: Runs SQL in sandboxed environment
+- **Refiner**: Self-correction when validation fails
+
+## 🔐 Security Features
+
+- **RBAC System**: Role-based access control for data access
+- **Schema Validation**: All queries validated against schema before execution
+- **Sandboxed Execution**: SQL runs in isolated processes
+- **Query Limiting**: Row limits, timeout controls, and byte limits
+- **Audit Logging**: Comprehensive logging of all operations
+
+## 📊 Observability
+
+- **OpenTelemetry Integration**: Native support for distributed tracing
+- **Metrics Collection**: Performance and operational metrics
+- **Audit Logs**: Persistent forensic logs for compliance
+- **Structured Logging**: Rich, contextual log information
+
+## 📁 Directory Structure
+
+```
+src/nl2sql/
+├── api/                  # Public API modules
+│   ├── query_api.py      # Query execution API
+│   ├── datasource_api.py # Datasource management API
+│   ├── llm_api.py       # LLM configuration API
+│   ├── indexing_api.py  # Schema indexing API
+│   ├── auth_api.py      # Authentication API
+│   ├── settings_api.py  # Settings API
+│   ├── result_api.py    # Result management API
+│   ├── policy_api.py    # Policy validation API
+│   └── benchmark_api.py # Benchmarking API
+├── auth/                # Authentication and RBAC
+├── common/              # Common utilities and settings
+├── configs/             # Configuration management
+├── adapters/            # Database adapters and the SQLAlchemy base
+├── cli/                 # `nl2sql` command line interface
+├── datasources/         # Datasource management and discovery
+├── execution/           # Execution engine and artifacts
+├── indexing/            # Schema indexing system
+├── llm/                 # LLM management
+├── pipeline/            # Graph orchestration
+│   ├── nodes/           # Individual pipeline nodes
+│   ├── subgraphs/       # Subgraph definitions
+│   └── routes/          # Routing logic
+├── schema/              # Schema management
+├── secrets/             # Secret management
+└── context.py           # Application context
+└── public_api.py        # Public API facade
+```
+
+## 📋 Configuration
+
+The engine requires configuration files for:
+- `configs/datasources.yaml` - Database connection configurations
+- `configs/llm.yaml` - LLM provider configurations  
+- `configs/secrets.yaml` - Secret management configurations
+- `configs/policies.json` - RBAC policies and permissions

nl2sql_engine-0.1.0.dist-info/RECORD

@@ -0,0 +1,192 @@
+nl2sql/__init__.py,sha256=m4e97zJ9te5OkWdj4p4G1I5_rB5RWlMYY8cUxu-t0Ik,973
+nl2sql/context.py,sha256=qu6PVYyQQ0LACeZWFscMugDtfDEBs4GYCC7u578N3ow,4228
+nl2sql/public_api.py,sha256=NvDOgmOjL0zdnNiqeySbljeV85H31DgXCHHf3TNbL_U,6584
+nl2sql/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/duckdb/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/duckdb/adapter.py,sha256=leogUO8MNE3VuUXLRCyRzS_B3zJq4QL5J_Q6GML75lU,2444
+nl2sql/adapters/mssql/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/mssql/adapter.py,sha256=7ICxA75CQMqB-tFturuYN9gtlw5-ppcWyltaGAs6mWI,4367
+nl2sql/adapters/mysql/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/mysql/adapter.py,sha256=0aXjUZiVBAPuBKOs8-bTCy3bmyB-hzpUqsLv7P8W04o,4320
+nl2sql/adapters/postgres/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/postgres/adapter.py,sha256=c8XuR91nt-g8g8Sce6kmhgtf5Z1xPMhUHiiT72jmYj0,4187
+nl2sql/adapters/sqlalchemy_base/__init__.py,sha256=sd-v8GZsiEOawLc8RuGHWoiath2utLzTO7hnAWH8PUg,293
+nl2sql/adapters/sqlalchemy_base/adapter.py,sha256=MKf3E49J9UHUrjURvOxKbajvmzTXjv6RENpNvwp9Ej0,17916
+nl2sql/adapters/sqlalchemy_base/models.py,sha256=DBo3kODkJYo3wsbqnPktYbrMCrBga2KA2w2_9c1pySQ,1035
+nl2sql/adapters/sqlite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/adapters/sqlite/adapter.py,sha256=BbW1FRtI4CebWSksBj1GO44mSqhroaOeMiwsvwoAiZw,3069
+nl2sql/aggregation/__init__.py,sha256=OkO0MKT6Is7WkXiE6AcdLpTQVP5sD0gLWkSdABqOk5A,77
+nl2sql/aggregation/aggregator.py,sha256=Pqzyr4dPioFvuM0s-G1edu2lNUIPWa-iyRP_i0C0PDQ,3682
+nl2sql/aggregation/engines/__init__.py,sha256=tDu4jAoFuCsv5XMz-ura-iZu4dz-C-syBsYxqH7PdAU,80
+nl2sql/aggregation/engines/polars_duckdb.py,sha256=IRx1AB-fm8OlhSa5Uzzt86-j5eaIPQ6Mgv_-i6Gocog,5368
+nl2sql/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/api/auth_api.py,sha256=LQuQUuyX21J6SYORyrRl-nZz9JvBIqRnVjapyEpBv5s,1545
+nl2sql/api/benchmark_api.py,sha256=U4MO4f0ZyNSlYPo-2eH_mnezUn71kM1uC7BrvxRSK0g,4210
+nl2sql/api/datasource_api.py,sha256=KqE-MALBipP3YUtxZKDNA-Ok0KnTZc9o-AGXCYLlkHw,3848
+nl2sql/api/indexing_api.py,sha256=CRapkkr5Me3rkAvxvSNRuy5RSv5uUyQh0Dq6p5DDFvo,1610
+nl2sql/api/llm_api.py,sha256=Na2uoTnTDL_66ZAiccYlYA8LwRXgY5A7Nou5-RvzK78,2118
+nl2sql/api/policy_api.py,sha256=22UttQ1GAFEH2Cqzu0RpLRwWDRs1P328tp2B7MRP20A,4904
+nl2sql/api/query_api.py,sha256=nlPnrge9J8spBVYCfQLA4JXPVMeOhQfXcBFaH6Nirw8,4763
+nl2sql/api/result_api.py,sha256=rbld5ixySxmrUH6-jjaRgBQAeBPj-rKP-blk4InOIM4,460
+nl2sql/api/settings_api.py,sha256=9ZpZ6ovnSxtbXzP1fYjKgP22ArtIVBZ_C_MgBquqt3E,1768
+nl2sql/auth/__init__.py,sha256=7XFvUBN1L4nRI9KZIXe_Gaa3ggs4lsKq4phA_aXXqzM,130
+nl2sql/auth/models.py,sha256=xGs2xeDyuosdwdtITWaLjvp0ViX_7A4vMqcBKNYRd6I,1683
+nl2sql/auth/rbac.py,sha256=SBhJoSDAkiOHTtTc5HOfOBKKrcJ-IOxZ5kPAxoCSsW0,1005
+nl2sql/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/cli/checks.py,sha256=U1n2JwmpyhkxGPeghtQjSoHq-NWHNHfca2sOQb11t6U,1914
+nl2sql/cli/config.py,sha256=S8eAAcMy1dRvNgxCtAECja_2b7tM9q1dHg3DWS4sV5A,762
+nl2sql/cli/console.py,sha256=116IrHIPd0h-fOjp7J5KOwgR3Rj1cEt3rXvfIR0CjCc,1862
+nl2sql/cli/main.py,sha256=LB9eBv8_ynA_l5LT7ttN1vMzUzVY3IThyHqSCA7VsQc,7309
+nl2sql/cli/reporting.py,sha256=gUE5B5JpZGj6IPPkhiYAt0fyzO6FoCRAsM74R3KLAc4,34251
+nl2sql/cli/types.py,sha256=sq7_xp3avnpKkf7dNEpULxgi1XOvlak_zV-cZUKi44E,291
+nl2sql/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/cli/commands/benchmark.py,sha256=UEXBlEJmPVwLH2ZGbeFTm9SCQpKXsUxmsN1QA35gzUo,1161
+nl2sql/cli/commands/doctor.py,sha256=XqNvHdQDP9bXc6qzmwKv56tNRGcTLL78K_bK1VgzpN4,1669
+nl2sql/cli/commands/indexing.py,sha256=ECbDv8m0BDHQCIuVqCxwTym7c6P7OjNN5MnV_L8dRag,4532
+nl2sql/cli/commands/info.py,sha256=ecEC1Nqqc9N3Y7U6Q1SJH8WV77jWhoHrYMs4L2dXQc0,876
+nl2sql/cli/commands/install.py,sha256=EqfFiyYhVHrLmFFcde0o800kCXV2GuUKJShGlb7umHU,951
+nl2sql/cli/commands/policy.py,sha256=RAYUAP4PM_63MyCozcyPuPVadM4XWjrz4yfBo3yZtCY,2264
+nl2sql/cli/commands/run.py,sha256=YPBvDlrpVUuxKveU1JPeKYXX0K0fB_d19obRKIcOSSg,5867
+nl2sql/cli/commands/setup.py,sha256=_LWv0hrPo4fZFTcv84mPcWgB3Pg_0qjz35dsWRiveFE,15817
+nl2sql/cli/commands/visualize.py,sha256=4lnWXKCveZkm9PaIIz_v5Ow09bWf0NpA3ttq0JmYqoQ,1182
+nl2sql/cli/common/decorators.py,sha256=Z6smQwwcPr-q6OzYDlpHoLvbyshGyimkruJylZACT8E,1182
+nl2sql/cli/demo/__init__.py,sha256=Qga08KwXp2l2LgWBigddmUB823Igk8He1b8scJkjfGM,32
+nl2sql/cli/demo/data.py,sha256=-jYnywWyT_QgHwwLcdJFA1G7pzPJCoAtHwPlFORNRfo,4274
+nl2sql/cli/demo/defaults.py,sha256=gTQPZ8jZHJ-9h2kkfpW4c-2lfI3ENZueNQEWSUeOTaQ,4682
+nl2sql/cli/demo/factory.py,sha256=YO69fozr7f_cskDpZjEPyYYvfwBvQMBnQmQyjUiNLPw,11640
+nl2sql/cli/demo/manager.py,sha256=UP8B2ZAh-bcdfUmm0bLuJNu7ypVZ_t7f36Pm6dnbArY,8892
+nl2sql/cli/demo/schemas.py,sha256=UMl0BVy1FooJrNhSx_epOEL5gGpfGf7BGJKPN7w-EeE,7760
+nl2sql/cli/demo/writers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/cli/demo/writers/docker.py,sha256=ZzHUVKNcfxrHVcQSLvjUaPE2UCDBfoqHbVIEWEaC5b8,5908
+nl2sql/cli/demo/writers/sqlite.py,sha256=vTVt9_eq83z-7JPiPUY5vA5uCtlcb-DfscPcoTOrpcM,2846
+nl2sql/cli/generators/datasources/__init__.py,sha256=CqfdZ8viIWec14z0FvOL1cbB1W8MVaIz_pZuu-fLm_Y,78
+nl2sql/cli/generators/datasources/generator.py,sha256=oO7vD0ZmI927mp0oTkS5lZGWHz4EdzAXUq2r0Ml8Shg,705
+nl2sql/cli/generators/datasources/templates.py,sha256=WpH2o8Ma_9Kegq0YLQD2lLNYQiPkHjgGWYf56OTToU0,162
+nl2sql/cli/generators/env/__init__.py,sha256=8ImX-Gam9P9Fr7AkorO68_B4n-tyhgUiiUy9Us7w4V8,72
+nl2sql/cli/generators/env/generator.py,sha256=-bDazC0wzcqP9B2Q2k7fTVAG6Cn1kPSw9Ftbdku_r1s,1646
+nl2sql/cli/generators/env/templates.py,sha256=l0tEe0xT6qWuLzdGjTgvcnSKOV-RE-uWQzYQtGjxEuc,751
+nl2sql/cli/generators/llm/__init__.py,sha256=fl2hcUjBcifOJtaT5VLFJYGm0pmqmHUKM3ND9kpSPQ0,64
+nl2sql/cli/generators/llm/generator.py,sha256=rUnCMXsBlzGKCYLtHx-zEDKZevJjJXmI3i1hVDjcdRw,661
+nl2sql/cli/generators/llm/templates.py,sha256=8bLYbbD_9u2E8-W5iSmhAmsrg4ueNOXXhijD8r19SKY,67
+nl2sql/cli/generators/policies/__init__.py,sha256=72eZRKt9FSHkO9FoMFaVwaTx0fUfw9P1cjYn2EJR_5I,70
+nl2sql/cli/generators/policies/generator.py,sha256=yMFPNRABIdXKEmwY7LmhUUoMrB4hj9cw8l7MPwzt06I,533
+nl2sql/cli/generators/policies/templates.py,sha256=hlVPkgkShmMaUzSvwrdQxleMPnVsBbkgO4wLOhKBSMM,38
+nl2sql/common/__init__.py,sha256=tykA9lJj-Ls0bwLCqTsRmvKeOE6Xalti3LGXQ69HnYg,65
+nl2sql/common/cancellation.py,sha256=uKaExUiPqzqdPxh1Qj5wPDyyP8YExdid9txt1bY3m84,650
+nl2sql/common/context.py,sha256=K20QOLhr33LwvEKoNyfFnX7BhyJUveOiIrXBc57lp74,222
+nl2sql/common/errors.py,sha256=FlflYXrgxAIaKGgiWrpVgaH2pzMEJq7xsHbZ7mlPSSg,3971
+nl2sql/common/event_logger.py,sha256=z0L9cvF7tkqin47N6XTwN7B8xqLWWYPJX-6fI2VKLXw,3054
+nl2sql/common/exceptions.py,sha256=RIPwDoszksPmZlmexgwMZsdpjh4h1NVYrEkRDdkD7Xw,87
+nl2sql/common/logger.py,sha256=vchEv6yxd0Gsk9PHjrv3H8rt1ziA3tsEtcDYTyRNgrE,3742
+nl2sql/common/metrics.py,sha256=6QEiVbdoq2A_w52T7MnWwzgFR95Mfgydwmp-fqLJ7BA,1711
+nl2sql/common/resilience.py,sha256=UsLy5rhHWPnd0_eFA614hQJIZoLjB1h4dTj535PDKKc,1874
+nl2sql/common/settings.py,sha256=mMhvB3_mTp5frytFAx-LjdTttIB40iG3V6tOmfpaQi0,7583
+nl2sql/configs/__init__.py,sha256=4pYb-vxyiMuvmwKy9raJRbozT0XqcVmpL3H79sf1mv0,255
+nl2sql/configs/datasources.py,sha256=b6o855sSf8WRn_C6rv1TIDk9JXmXjjqO6GbrwteudU4,346
+nl2sql/configs/llm.py,sha256=Vr1WM_GZ0gn8aQ2BDk7EGDXonEUiBuH3Dy-nJiGv_j0,1399
+nl2sql/configs/manager.py,sha256=Am7P3nFixlLJTH2oJHtHrEy3JhpHD8r8LWZkPqWzel0,6698
+nl2sql/configs/policies.py,sha256=PYM5lHY7tzzr_1Ro89mwT1U_XQL23CSec0DJ8SZDoU4,310
+nl2sql/configs/sample_questions.py,sha256=fJ_ODJgIJjwszSivaIlxwhG24FF88JaB-7pdqdPgxL0,298
+nl2sql/configs/secrets.py,sha256=0PNsq7VZIBU3YcjGDuHyY3g-kVUQh4SNb4F2d0jzaJY,303
+nl2sql/datasources/__init__.py,sha256=XtCMiDbHl6h_dwPzlS7eQY6lkECx5gDZyDVtfb0HbRc,690
+nl2sql/datasources/discovery.py,sha256=McqjehO8ABhIvZLCCnoT2siX-9yGuqwkvPHdrIzL09o,916
+nl2sql/datasources/models.py,sha256=NqhA_NNWFdGTKnYYPr6RJ02IG7D03LZVPyAyNTvE95Q,448
+nl2sql/datasources/protocols.py,sha256=QaD7RH2CF5lxZp-3EJqwZF6QaSUi5SGC0zWY4-4xbbM,108
+nl2sql/datasources/registry.py,sha256=j6229xcdjdo8QM3YIm76RiwAWKDPSytEQjbrPrFlpV4,6410
+nl2sql/evaluation/__init__.py,sha256=dptaqnaxm1ENl4cfUgfRvyg-n-XPgfR3-rzTGWaEo18,286
+nl2sql/evaluation/benchmark_runner.py,sha256=r5J39zoPBQeErOYhjtUUhm-x6iRFFleGmC5HXiw1xVA,11856
+nl2sql/evaluation/evaluator.py,sha256=Uljoq5HCJYGO1T8nEFGQFEy-J0lT-nYd1OTDT_Z_l1M,5246
+nl2sql/evaluation/types.py,sha256=1fVZ7JsONqvTeqjOZHNLHt0OYMTU_e8kJTJttfGfFUM,649
+nl2sql/execution/__init__.py,sha256=ByIg595_NRAmadjRmwas-pTFPOkjya3pVrht9XBq2Ag,198
+nl2sql/execution/contracts.py,sha256=Vb_cHsb4gvCdUWQlnPzR8vER1ezf6Yew2Ng_a1-Wx_A,1479
+nl2sql/execution/execution_store.py,sha256=42KYFygO51bRFVxKL11iky--4n8MIqeMhAwT-_8Ivv0,697
+nl2sql/execution/artifacts/__init__.py,sha256=QA6SoTROWjzaQN74of1BwPz_ZR6xMNiQp4WOQ8Wznvo,152
+nl2sql/execution/artifacts/parquet.py,sha256=bMODj2Az4LSib0tOZ47wxrNpS8ErcbiDwYAdA_3lidM,1096
+nl2sql/execution/artifacts/store.py,sha256=mNlKXPX0044k2zqpJPpb0Xws2pxQ2kcpUtPKnlmBeyk,6128
+nl2sql/execution/executor/__init__.py,sha256=Fk-N__HmdycOzoq-CBvAyqCa6sQ1i8R6gymgydC_6FM,79
+nl2sql/execution/executor/sql_executor.py,sha256=63_GYVFRABEJJBiO_XDOA3KIl6HA2_xXA20azUDdH9s,4362
+nl2sql/indexing/__init__.py,sha256=OAE62dnE2JX-tEb2GNKk1VGyI2FapuK7mSmn39ENhAA,146
+nl2sql/indexing/chunk_builder.py,sha256=rPkCy6spBNHFRNMurbaAh4lDnDD1496GnlHU5EYTjZQ,7578
+nl2sql/indexing/embeddings.py,sha256=sVYZOlb9HogDSU6vT_ZM2cGFfVUESviBW3wwhYVfzmw,5846
+nl2sql/indexing/enrichment_service.py,sha256=pkizpHp4ml63vBD2mql4tG9FZ6GV1kbQYs3S0zHPDIU,11275
+nl2sql/indexing/models.py,sha256=lkLnLiYqhbW3tVKLAL-32DejJcIDXQXiQburW1bIm6g,6268
+nl2sql/indexing/orchestrator.py,sha256=CoQ6KgvYE1sUZS30DUxtjTRJTLm76wxEoT9A7sfPqmY,2808
+nl2sql/indexing/vector_store.py,sha256=Gtov4RcqZv3dW2iT9hAjEUa_glkHf1li-Y9wsRYT0AU,12818
+nl2sql/llm/__init__.py,sha256=6zezlG3rcTR8aEMNP1pyjTdP3_McsLN--rD10Y12g_w,119
+nl2sql/llm/models.py,sha256=hbjs6x6ivwsceyhJ0Xiu0yHKw3pMVn5nMQlsk9IoXKM,312
+nl2sql/llm/registry.py,sha256=-dBH-fFtNHW4cN6HPM0UaFZ6Bi4NqkBiUmRjlxs6zvo,7790
+nl2sql/pipeline/__init__.py,sha256=zCseU4QhuaPHxEx4GmbKjv4cXo0fpiqchkyzg4cYy-c,81
+nl2sql/pipeline/graph.py,sha256=Q294D0FUEt0faWXPtxY-l4DtwlweO79Ku1SoPFnPEaU,2627
+nl2sql/pipeline/graph_utils.py,sha256=lVlrMeyHd-ygSKZBuSLZBVAqVjKTQqhRNRBFUECYnIQ,4777
+nl2sql/pipeline/pipeline_runner.py,sha256=Uhpfd_fu649Ubd5FXfnmUWZqFXyKHIRxeDlnk1pPsmg,1926
+nl2sql/pipeline/routes.py,sha256=yEIjHhrO3Sbqg7MPix-dCSgjarZcmyb_I9lb6OZpo0A,2559
+nl2sql/pipeline/runtime.py,sha256=TL6NYADAD-FYOP1RIZgNxeSzxTQMtwXOPkNNwnclLW0,4602
+nl2sql/pipeline/state.py,sha256=vHJ6GvDpAds9Uoutr87ef6OWkB8Em8Ly2mqdh53sBgo,5291
+nl2sql/pipeline/nodes/__init__.py,sha256=Jwp4oVZGSRhDhbLJSOkVVU4zX_5Bm4yftfF3KKAGbOU,825
+nl2sql/pipeline/nodes/aggregator/__init__.py,sha256=qxSeVg8GxlVV9A22OpS4Nk-WlzQ6JNGNMRj6JvY_a70,137
+nl2sql/pipeline/nodes/aggregator/node.py,sha256=Ms8cjqf4S_fOUXlDWPAAur2dH7Q6tctrktV-9ooTvws,2263
+nl2sql/pipeline/nodes/aggregator/prompts.py,sha256=N4q_pcw7umy5h4RuiSooKJ7rbcEZ7-S93KjS0k-8Sd8,778
+nl2sql/pipeline/nodes/aggregator/schemas.py,sha256=Rhcj28iKQuw3p-PRcB_UiitRbihNG6HLNA6DJMWaGyg,1323
+nl2sql/pipeline/nodes/answer_synthesizer/__init__.py,sha256=tPmGUEv5wQmfRh5qTGi4gMaPXI0gOz7p_noVTD6PGo8,195
+nl2sql/pipeline/nodes/answer_synthesizer/node.py,sha256=Qj6zwIGROwbLrlEa5YzgBOS8yC9i3hXbTbE9G4FB5r0,3627
+nl2sql/pipeline/nodes/answer_synthesizer/prompts.py,sha256=sYMMl1ZKAGTIF0in_6unUMflY6-_HyQdm9DIOrRQVV4,619
+nl2sql/pipeline/nodes/answer_synthesizer/schemas.py,sha256=ubonMQii5BAbXj7e88r-O-PiYo-FOzNBVLtu5oUCJ7E,1000
+nl2sql/pipeline/nodes/ast_planner/__init__.py,sha256=Pi9Y2Jn95J8LvcapWc0WB13Y3gKGYrO7bT2vLq_Kig4,125
+nl2sql/pipeline/nodes/ast_planner/node.py,sha256=vEBwVnnwtG6q1CNraofBVdwxR7bX3nEi9l5l-TMeJJg,3817
+nl2sql/pipeline/nodes/ast_planner/prompts.py,sha256=dBsjhhhDYl3m26Cj0gJtLV6PA6uWj23NA4cptZACb94,4387
+nl2sql/pipeline/nodes/ast_planner/schemas.py,sha256=LNkJ4OI-AeY_ax7NPtg7T7lh5Ib_c1GaRAq10Rykl6Q,7716
+nl2sql/pipeline/nodes/datasource_resolver/__init__.py,sha256=cqqBhps2uxY5rJ45ak15u3jAqBUcDzVMewjqKpMXkQ4,199
+nl2sql/pipeline/nodes/datasource_resolver/node.py,sha256=aIbzZxD6BjzhGRYTc261OOKHzOf9LPZcvPyKjMk5XOQ,10360
+nl2sql/pipeline/nodes/datasource_resolver/schemas.py,sha256=OrGwpHf3sFIk2LvkD5s95qKABlzbyyLUw68dQMCEDW8,641
+nl2sql/pipeline/nodes/decomposer/__init__.py,sha256=_-RRipNfIUonSQghdx6mJ4PqJ0WRl7pBX3ouY-Vjsr4,63
+nl2sql/pipeline/nodes/decomposer/node.py,sha256=UQNgMwUjkoHOghIkP4rEXVnF1h3Lad-lMy073DYdJaE,9213
+nl2sql/pipeline/nodes/decomposer/prompts.py,sha256=jlqPLp6bYpPnhxkkY7yUIqofhlwEstb4j9pHZd_huUA,2955
+nl2sql/pipeline/nodes/decomposer/schemas.py,sha256=yX8RVgZY5OonDeGmjnEKp7TLVWXPFPwNpkGkHTXv8Ro,5078
+nl2sql/pipeline/nodes/executor/__init__.py,sha256=rOAHGAS8MoOc8pEneRmEaHbdKcue-AdPhpwecgKkAxE,59
+nl2sql/pipeline/nodes/executor/node.py,sha256=UiKLxTo6VaZxR6pXtzjw2pTiEF-WjKVD10BpyMjivWc,4176
+nl2sql/pipeline/nodes/generator/__init__.py,sha256=4UlJYWooS6pwO-QqxEEJaLztLilvHmmuEn7_Np86y94,121
+nl2sql/pipeline/nodes/generator/node.py,sha256=jmNYrtwDfpobI0JWmkZogMfYOCfyt7K9Kv8N1Aw7184,9939
+nl2sql/pipeline/nodes/generator/schemas.py,sha256=zhe38rq6GDexlkgjAJaQd0U6ptxXt2uAFW0-I9LZ7Fk,370
+nl2sql/pipeline/nodes/global_planner/__init__.py,sha256=0RK5WF80ngh_8wf_bEBIr4DO2BJ9xJAY0dviaN8T--g,137
+nl2sql/pipeline/nodes/global_planner/node.py,sha256=Xru-nrh8WpVKciwng8IK4iIVZpJwdL5AWSLQ3rEiGSY,7815
+nl2sql/pipeline/nodes/global_planner/schemas.py,sha256=fZ1PtEGyK1Xf47i_C8mE-27EsPnnN0j_tCW1Ap2LUlc,2895
+nl2sql/pipeline/nodes/refiner/__init__.py,sha256=_YcGaSWzuYFVyqQo-XnqtIxz1YsVdYlRXYkKh3ST3SQ,113
+nl2sql/pipeline/nodes/refiner/node.py,sha256=7aqQ65wQ-dqgJY1LksK4nuCj_siQzzjxHSTY1aZI1ag,4974
+nl2sql/pipeline/nodes/refiner/prompts.py,sha256=H8zcvKSK6Gl8jRRwl1QqEodoWbH694-0iEgBYK8Vzf0,1056
+nl2sql/pipeline/nodes/refiner/schemas.py,sha256=BX6Br2otLwbJg46_4MDU5NyAneuxiYhqycUGZ2YSxOM,367
+nl2sql/pipeline/nodes/schema_retriever/__init__.py,sha256=miMgIAwDzvrYbnsjgSdnYPEPmNQuKGZQWp7dkzxAM_4,73
+nl2sql/pipeline/nodes/schema_retriever/node.py,sha256=JwsAirR1nCY-9GWh1h5u4GxaQ0nnOm4GfqXCNLa3qlA,9693
+nl2sql/pipeline/nodes/schema_retriever/schema.py,sha256=-lhZnubzXTOIM5Iub2gomjTLx2DzhfndJWUYTe1TBkQ,692
+nl2sql/pipeline/nodes/validator/__init__.py,sha256=SDrs6nZ4okjv8JRg427RlasVeGYA1J99arKQZZiNNzo,160
+nl2sql/pipeline/nodes/validator/node.py,sha256=kzJYWQIuPHDvC7P8u4CtIOy77jlxPuZ0Nf9poI647lM,33724
+nl2sql/pipeline/nodes/validator/schemas.py,sha256=skyWdEKWGwU8rQM4Pit8eR6DrXf-3Do3lYP0b7dmPbM,331
+nl2sql/pipeline/subgraphs/__init__.py,sha256=H-VTzAeo0AfIJhoIohC5xGgCsa39K8xEFx0q7aUDkIQ,99
+nl2sql/pipeline/subgraphs/schemas.py,sha256=CleoVqsvxPshYZHFu7QcQH26c8AFiw-fQ_G2hacq22g,784
+nl2sql/pipeline/subgraphs/sql_agent.py,sha256=nUHYArt0IHGpwRiY28xhns2wPGZ5N574kA1LHSE_6nc,6087
+nl2sql/schema/__init__.py,sha256=Ko4aw9jxijU5YHMuFfp97mKXF_Bsoxc8F5BZsm-_x5w,869
+nl2sql/schema/in_memory_store.py,sha256=zkUNPDRvLDU5StgfFPiLYyuIH8tSdVX0AtDSJJdTa-s,6318
+nl2sql/schema/protocol.py,sha256=16bqaFmmk3XujnovsEpWHkNd6tpoya4qEbDzFYGw8Bw,2504
+nl2sql/schema/sqlite_store.py,sha256=CyP8e350QLpwfrj5Nl0sSrwnRPORuzTThmz69NUB4Kk,7637
+nl2sql/schema/store.py,sha256=Nx74EwtPEEoJUR2zds0OdGqA7bKjQBihRGoQ2o92Up8,854
+nl2sql/secrets/__init__.py,sha256=cnTUjcM_YwkqIWhJ5zdVSLOnwar0t87R6tySh1NcaFE,328
+nl2sql/secrets/factory.py,sha256=wVLV6vpl6uzymtUFYtLHGRBPtA6BKX0cpz77jwCpfU4,3309
+nl2sql/secrets/interfaces.py,sha256=XhQCUGms_d1Y3TG5nJCO7SrP43CqmlXMPHk1KMjNyz4,460
+nl2sql/secrets/manager.py,sha256=zXQMGgdEshMruCKk1nJyjXw58TaBFA4SKEcfkrEYO1k,5182
+nl2sql/secrets/models.py,sha256=OEVEfamjauVkHrtDTftec4wYSGgwk7f0XsC8ZGztSV0,2234
+nl2sql/secrets/providers/aws.py,sha256=dbnrudkq8ZQ13u89tlihTXE-tLG1AKkLtv_Z0DMRyvE,1245
+nl2sql/secrets/providers/azure.py,sha256=6Fqw_H6i9gadu8ey-_BTtp9RYcSH3wTMeJ6MTIDitVA,2054
+nl2sql/secrets/providers/env.py,sha256=Ibwroaj2KwPkroVJuIC3glzS05_axZ1BEsM6l5kl_BM,219
+nl2sql/secrets/providers/hashi.py,sha256=RwC4QBxziILTruRvcynJFMRsF1r1t183WDXxDJqybGs,1675
+nl2sql/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/services/callbacks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nl2sql/services/callbacks/monitor.py,sha256=hFwneVamQcvpcqG-uaQUZRL0oBq4eHU_Cy-qVW4YKDs,3353
+nl2sql/services/callbacks/node_context.py,sha256=bt8udW1MZsQlPH-9acpcvYU3uoZCL27JthLkT6ml7MA,176
+nl2sql/services/callbacks/node_handlers.py,sha256=ufovJXAYzeJ4eFvbKKUJQnYHNws5GW_ihMBZlf-Y25E,6393
+nl2sql/services/callbacks/node_metrics.py,sha256=DD1wraqi01TbtCltTrDyQQ-cngFb0Pvy6GQyhj3ZcKA,339
+nl2sql/services/callbacks/presenter.py,sha256=12-8nD0CSiHrQ2z-gbMhP6983bg_ykb93VZcuEj0yTM,266
+nl2sql/services/callbacks/token_handler.py,sha256=TROVTrIObR-0HiZBTIbfbPyF_aEXu0OdRrZNVc28VB4,1920
+nl2sql_engine-0.1.0.dist-info/METADATA,sha256=pyWBbYHJhGOwZGlV61KmzZ2-KkswORBU0BhoUohFr9Q,12554
+nl2sql_engine-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+nl2sql_engine-0.1.0.dist-info/entry_points.txt,sha256=EAg8ovR1A1r8Ri_jr8eO9yQQjTAIy398qotlTgdr9n0,337
+nl2sql_engine-0.1.0.dist-info/top_level.txt,sha256=B_NI1U1LA9E8_I9xAGOL1xLjnJs4wrWQocsGIjO3uvg,7
+nl2sql_engine-0.1.0.dist-info/RECORD,,

nl2sql_engine-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

nl2sql_engine-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,9 @@
+[console_scripts]
+nl2sql = nl2sql.cli.main:main
+
+[nl2sql.adapters]
+duckdb = nl2sql.adapters.duckdb.adapter:DuckdbAdapter
+mssql = nl2sql.adapters.mssql.adapter:MssqlAdapter
+mysql = nl2sql.adapters.mysql.adapter:MysqlAdapter
+postgres = nl2sql.adapters.postgres.adapter:PostgresAdapter
+sqlite = nl2sql.adapters.sqlite.adapter:SqliteAdapter

nl2sql_engine-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+nl2sql