feat: add native Trino driver

README.md

@@ -167,7 +167,7 @@ Each mode has scoped permissions, tool access, and SQL write-access control.
 
 ## Supported Warehouses
 
-Snowflake · BigQuery · Databricks · PostgreSQL · Redshift · ClickHouse · DuckDB · MySQL · SQL Server (incl. Microsoft Fabric) · Oracle · SQLite · MongoDB
+Snowflake · BigQuery · Databricks · PostgreSQL · Redshift · Trino · ClickHouse · DuckDB · MySQL · SQL Server (incl. Microsoft Fabric) · Oracle · SQLite · MongoDB
 
 First-class support with schema indexing, query execution, and metadata introspection. SSH tunneling available for secure connections.
 

docs/docs/configure/warehouses.md

@@ -1,6 +1,6 @@
 # Warehouses
 
-Altimate Code connects to 12 warehouse types. Configure them in `.altimate-code/connections.json` (project-local) or `~/.altimate-code/connections.json` (global).
+Altimate Code connects to 13 warehouse types. Configure them in `.altimate-code/connections.json` (project-local) or `~/.altimate-code/connections.json` (global).
 
 ## Configuration
 
@@ -118,6 +118,50 @@ If you're already authenticated via `gcloud`, omit `credentials_path`:
 | `catalog` | No | Unity Catalog name |
 | `schema` | No | Schema/database name |
 
+## Trino
+
+```json
+{
+ "trino-prod": {
+ "type": "trino",
+ "host": "trino.example.com",
+ "port": 8443,
+ "protocol": "https",
+ "catalog": "iceberg",
+ "schema": "analytics",
+ "user": "analyst",
+ "password": "{env:TRINO_PASSWORD}"
+ }
+}
+```
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `connection_string` | No | Full server URL (alternative to host/port, e.g. `https://trino.example.com:8443`) |
+| `host` | No | Hostname (default: `localhost`) |
+| `port` | No | Port (default: `8080`, or `8443` when `protocol` is `https`) |
+| `protocol` | No | `http` or `https` (default: `http`) |
+| `catalog` | Recommended | Default catalog for query execution and required for schema/table introspection |
+| `schema` | No | Default schema |
+| `user` | No | Trino user (default sent by the client if omitted) |
+| `password` | Auth | Basic authentication password |
+| `access_token` | Auth | Bearer/JWT token |
+| `extra_headers` | No | Additional HTTP headers to send to Trino |
+
+### Using a bearer token
+
+```json
+{
+ "trino-prod": {
+ "type": "trino",
+ "connection_string": "https://trino.example.com:8443",
+ "catalog": "hive",
+ "schema": "default",
+ "access_token": "{env:TRINO_TOKEN}"
+ }
+}
+```
+
 ## PostgreSQL
 
 ```json
@@ -471,7 +515,7 @@ The `/discover` command can automatically detect warehouse connections from:
 | Source | Detection |
 |--------|-----------|
 | dbt profiles | Searches for `profiles.yml` (see resolution order below) |
-| Docker containers | Finds running PostgreSQL, MySQL, SQL Server, and ClickHouse containers |
+| Docker containers | Finds running PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, and Trino containers |
 | Environment variables | Scans for `SNOWFLAKE_ACCOUNT`, `PGHOST`, `DATABRICKS_HOST`, etc. |
 
 ### dbt profiles.yml resolution order

docs/docs/data-engineering/tools/warehouse-tools.md

@@ -54,7 +54,7 @@ env_bigquery | bigquery | GOOGLE_APPLICATION_CREDENTIALS
 | **dbt project** | Walks up directories for `dbt_project.yml`, reads name/profile |
 | **dbt manifest** | Parses `target/manifest.json` for model/source/test counts |
 | **dbt profiles** | Searches for `profiles.yml`: `DBT_PROFILES_DIR` env var → project root → `<home>/.dbt/profiles.yml` |
-| **Docker DBs** | Bridge call to discover running PostgreSQL/MySQL/MSSQL containers |
+| **Docker DBs** | Bridge call to discover running PostgreSQL/MySQL/MariaDB/MSSQL/Oracle/ClickHouse/Trino containers |
 | **Existing connections** | Bridge call to list already-configured warehouses |
 | **Environment variables** | Scans `process.env` for warehouse signals (see table below) |
 | **Schema cache** | Bridge call for indexed warehouse status |
@@ -73,6 +73,7 @@ env_bigquery | bigquery | GOOGLE_APPLICATION_CREDENTIALS
 | MongoDB | `MONGODB_URI`, `MONGO_URL` |
 | Redshift | `REDSHIFT_HOST` |
 | ClickHouse | `CLICKHOUSE_HOST`, `CLICKHOUSE_URL` |
+| Trino | `TRINO_HOST`, `TRINO_SERVER`, `TRINO_URL`, `DATABASE_URL` |
 
 ### Parameters
 
@@ -166,7 +167,7 @@ Remove an existing warehouse connection.
 
 ## warehouse_discover
 
-Discover database containers running in Docker. Detects PostgreSQL, MySQL/MariaDB, SQL Server, ClickHouse, and MongoDB containers with their connection details.
+Discover database containers running in Docker. Detects PostgreSQL, MySQL/MariaDB, SQL Server, Trino, ClickHouse, and MongoDB containers with their connection details.
 
 ```
 > warehouse_discover

docs/docs/drivers.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-Altimate Code connects to 12 databases natively via TypeScript drivers. No Python dependency required. Drivers are loaded lazily, so only the driver you need is imported at runtime.
+Altimate Code connects to 13 databases natively via TypeScript drivers. No Python dependency required. Drivers are loaded lazily, so only the driver you need is imported at runtime.
 
 ## Support Matrix
 
@@ -19,6 +19,7 @@ Altimate Code connects to 12 databases natively via TypeScript drivers. No Pytho
 | Databricks | `@databricks/sql` | PAT, OAuth | ✅ Live account | 24 E2E tests, Unity Catalog support |
 | MongoDB | `mongodb` | Password, Connection String | ✅ Docker | 90 E2E tests, MQL queries, aggregation pipelines |
 | ClickHouse | `@clickhouse/client` | Password, Connection String, TLS | ✅ Docker | HTTP(S) protocol, ClickHouse Cloud support |
+| Trino | `trino-client` | None, Basic, Bearer Token | ❌ Needs Trino cluster | HTTP(S) protocol, catalog/schema support |
 | Oracle | `oracledb` (thin) | Password | ❌ Needs Oracle 12.1+ | Thin mode only, no Instant Client |
 
 ## Installation
@@ -43,6 +44,7 @@ bun add snowflake-sdk # Snowflake
 bun add @google-cloud/bigquery # BigQuery
 bun add @databricks/sql # Databricks
 bun add @clickhouse/client # ClickHouse
+bun add trino-client # Trino
 bun add oracledb # Oracle (thin mode)
 ```
 
@@ -121,6 +123,24 @@ Optional: `location` (e.g. `us`, `eu`, `us-central1`, `asia-northeast1`). Requir
 |--------|--------------|
 | PAT | `server_hostname`, `http_path`, `access_token` |
 
+### Trino
+
+| Method | Config Fields |
+|--------|--------------|
+| No auth | `host`, `port`, `catalog`, `schema`, `user` |
+| Basic | `host`, `port`, `catalog`, `schema`, `user`, `password` |
+| Bearer token | `host`, `port`, `catalog`, `schema`, `access_token` |
+| Connection String | `connection_string: "https://trino.example.com:8443"` |
+
+Trino uses the official `trino-client` package over HTTP(S). Set `catalog` for schema/table introspection. Query history is not exposed as a durable history source by the native driver.
+
+> **Migration note:** earlier versions mapped the dbt `trino` adapter onto the PostgreSQL driver. It now uses this native Trino driver. If you have an existing `trino` connection or dbt profile, switch `database`/`dbname` to `catalog` (the `database` alias still resolves) and use `access_token` (aliased from `token`) for bearer auth. Behavior is otherwise compatible.
+
+**Troubleshooting:**
+- *Catalog required* — `listTables`/`describeTable` need `catalog` set; without it, introspection errors. Set `catalog` (or `database`, which is aliased to it).
+- *Auth conflict* — configuring both `password` (Basic) and `access_token` (Bearer) is rejected; use exactly one.
+- *Connection refused / TLS* — confirm the `protocol` (`http` vs `https`) and port; the driver defaults to `8080` for HTTP and `8443` for HTTPS.
+
 ### MySQL
 | Method | Config Fields |
 |--------|--------------|
@@ -193,7 +213,7 @@ SSH auth types: `"key"` (default) or `"password"` (set `ssh_password`).
 
 The CLI auto-discovers connections from:
 
-1. **Docker containers**: detects running PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, MongoDB containers
+1. **Docker containers**: detects running PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, ClickHouse, Trino containers
 2. **dbt profiles**: parses `~/.dbt/profiles.yml` for all supported adapters
 3. **Environment variables**: detects `SNOWFLAKE_ACCOUNT`, `PGHOST`, `MYSQL_HOST`, `MSSQL_HOST`, `ORACLE_HOST`, `DUCKDB_PATH`, `SQLITE_PATH`, etc.
 

docs/docs/getting-started/index.md

@@ -58,7 +58,7 @@ Altimate Code goes the other direction. It connects to your **entire** stack and
 
  ---
 
- Optimize a Snowflake query in the morning. Migrate a SQL Server pipeline to BigQuery in the afternoon. Same agent, same tools. No warehouse subscription required. First-class support for :material-snowflake: Snowflake, :material-google-cloud: BigQuery, :simple-databricks: Databricks, :material-elephant: PostgreSQL, :material-aws: Redshift, :material-database: ClickHouse, :material-duck: DuckDB, :material-database: MySQL, :material-microsoft: SQL Server, and :material-leaf: MongoDB.
+ Optimize a Snowflake query in the morning. Migrate a SQL Server pipeline to BigQuery in the afternoon. Same agent, same tools. No warehouse subscription required. First-class support for :material-snowflake: Snowflake, :material-google-cloud: BigQuery, :simple-databricks: Databricks, :material-elephant: PostgreSQL, :material-aws: Redshift, :material-database: Trino, :material-database: ClickHouse, :material-duck: DuckDB, :material-database: MySQL, :material-microsoft: SQL Server, and :material-leaf: MongoDB.
 
 - :material-cloud-outline:{ .lg .middle } **Works with any LLM**
 

packages/drivers/package.json

@@ -21,6 +21,7 @@
  "oracledb": "^6.0.0",
  "duckdb": "^1.0.0",
  "mongodb": "^6.0.0",
- "@clickhouse/client": "^1.0.0"
+ "@clickhouse/client": "^1.0.0",
+ "trino-client": "^0.2.8"
  }
 }

packages/drivers/src/index.ts

@@ -17,3 +17,4 @@ export { connect as connectDuckdb } from "./duckdb"
 export { connect as connectSqlite } from "./sqlite"
 export { connect as connectMongodb } from "./mongodb"
 export { connect as connectClickhouse } from "./clickhouse"
+export { connect as connectTrino } from "./trino"

packages/drivers/src/normalize.ts

@@ -98,6 +98,15 @@ const CLICKHOUSE_ALIASES: AliasMap = {
  tls_key: ["tlsKey", "ssl_key"],
 }
 
+const TRINO_ALIASES: AliasMap = {
+ user: ["username"],
+ catalog: ["database", "dbname", "db"],
+ connection_string: ["connectionString", "server", "url", "uri"],
+ access_token: ["token", "accessToken", "jwt", "bearer_token", "bearerToken"],
+ extra_headers: ["extraHeaders", "headers"],
+ extra_credential: ["extraCredential"],
+}
+
 /** Map of warehouse type to its alias map. */
 const DRIVER_ALIASES: Record<string, AliasMap> = {
  snowflake: SNOWFLAKE_ALIASES,
@@ -115,6 +124,7 @@ const DRIVER_ALIASES: Record<string, AliasMap> = {
  mongodb: MONGODB_ALIASES,
  mongo: MONGODB_ALIASES,
  clickhouse: CLICKHOUSE_ALIASES,
+ trino: TRINO_ALIASES,
  // duckdb and sqlite have simple configs — no aliases needed
 }