sandal-db 1.0.0 → 1.0.2

package/README.md

@@ -121,6 +121,7 @@ npx sandal-db@latest config --path
 ```text
 npx sandal-db@latest [options] [dbUrl]
 npx sandal-db@latest config [options]
+npx sandal-db@latest md [options] [fileOrText]
 ```
 
 ### Global Options
@@ -135,6 +136,8 @@ npx sandal-db@latest config [options]
 | `--no-strict`           | `flag`    | Disables strict safety mode.                                                       | `false`              |
 | `--allow-full-wipe`     | `flag`    | Explicitly permits database-level drops after interactive phrase confirmation.     | `false`              |
 | `--threshold <number>`  | `integer` | Row count threshold above which updates are classified as dangerous operations.    | `50`                 |
+| `--markdown`            | `boolean` | Formats and renders LLM responses as rich terminal markdown.                      | `true`               |
+| `--no-markdown`         | `flag`    | Disables terminal markdown rendering and outputs raw text.                         | `false`              |
 | `-V, --version`         | `flag`    | Output the version number.                                                         |                      |
 | `-h, --help`            | `flag`    | Display command help and exit.                                                     |                      |
 
@@ -164,6 +167,16 @@ Dot commands provide direct utility functions without issuing requests to the LL
 | --------------------------- | ----------------------------------------------------------------------------------------------------- |
 | `.tables` or `.collections` | Lists all discovered database tables or MongoDB collections with current row counts.                  |
 | `.schema [name]`            | Displays column names, data types, nullability constraints, and primary keys for the specified table. |
+| `.connect` or `.switch`     | Shows saved database connections; select by number or enter a new URL (preserves chat memory).       |
+| `.model [name]`             | Displays current model or switches to a new model on the fly.                                         |
+| `.provider [name]`          | Switches active LLM provider (`google`, `openai`, or `anthropic`).                                    |
+| `.key [remove \| set]`      | Displays active API key, removes it from config, or updates it live.                                 |
+| `.chats`                    | Lists all saved chat sessions with message counts and last active times.                              |
+| `.chat <id \| number>`      | Switches to a specific chat session and restores its conversation memory.                             |
+| `.new`                      | Starts a fresh chat session with clean memory.                                                        |
+| `.history`                  | Displays full conversation turn history for the active chat session.                                  |
+| `.clear-chat`               | Clears message history for the current chat session.                                                  |
+| `.md [file\|text]`          | Renders markdown file or inline markdown text with syntax highlighting directly in the terminal.      |
 | `.refresh`                  | Invalidates cached schema metadata and re-introspects the live database.                              |
 | `.clear`                    | Clears the terminal screen.                                                                           |
 | `.help`                     | Prints the interactive command reference and sample queries.                                          |
@@ -200,6 +213,102 @@ sandal [postgres]> Update users set status = 'dormant' where last_active_at < '2
 sandal [mongodb]> Delete error log documents created more than 90 days ago.
 ```
 
+#### Terminal Markdown Rendering
+
+SANDAL automatically parses and renders LLM answers with syntax-highlighted code blocks, formatted Unicode tables, bullet points, headers, and styled text directly inside your terminal:
+
+```text
+sandal [postgres]> Show top customers and give me an analysis.
+🤖 Answer:
+# Customer Insights
+
+Here is the breakdown of top revenue generators:
+
+┌─────────────────┬──────────┬──────────────┐
+│ Customer Name   │ Orders   │ Total Spent  │
+├─────────────────┼──────────┼──────────────┤
+│ Acme Corp       │ 34       │ $48,250.00   │
+│ Initech LLC     │ 28       │ $36,120.00   │
+└─────────────────┴──────────┴──────────────┘
+
+Key Findings:
+  * **Acme Corp** is the highest-value account with 34 completed orders.
+  * Recommended index for faster queries:
+    CREATE INDEX CONCURRENTLY idx_orders_customer ON orders(customer_id);
+```
+
+You can also view or render any markdown file or snippet directly from the command line:
+
+```bash
+# Render a markdown file in the terminal
+npx sandal-db md README.md
+
+# Pipe markdown from standard input
+echo "# Hello Terminal" | npx sandal-db md
+
+# Disable markdown rendering if plain text is desired
+npx sandal-db --no-markdown postgresql://...
+```
+
+#### Connection History and Database Switching
+
+SANDAL tracks your previous database connections automatically in `~/.sandal/config.json`. Inside the interactive REPL, switch databases at any time without restarting your session:
+
+```text
+sandal [postgres]> .connect
+
+Database Connections:
+  [1] postgresql://postgres:***@localhost:5432/analytics (Current)
+  [2] mongodb://app_user:***@cluster0.mongodb.net/production
+  [N] Enter a new connection URL
+  [C] Cancel
+
+Select a connection [number, N, C]: 2
+```
+
+When you switch databases, your **conversation history and chat memory are preserved**, allowing you to continue querying or comparing insights across databases.
+
+From the command line:
+```bash
+# List all saved database connections
+npx sandal-db config --connections
+
+# Remove a connection from saved history
+npx sandal-db config --remove-connection 2
+```
+
+#### Changing Models, Providers, and API Keys Live
+
+Modify your AI configuration during an active session:
+
+- `.model` — View recommended models for your provider (e.g. `gemini-2.5-flash`, `gpt-4o`, `claude-3-5-sonnet-latest`) or type a custom model name.
+- `.provider` — Switch between Google Gemini, OpenAI, and Anthropic Claude.
+- `.key` — View masked key information.
+- `.key remove` — Remove the stored API key for the current provider from `~/.sandal/config.json`.
+- `.key set <new-key>` — Update your API key dynamically.
+
+From the command line:
+```bash
+# Remove stored API key for a specific provider
+npx sandal-db config --remove-key google
+
+# Remove all stored API keys
+npx sandal-db config --remove-key all
+```
+
+#### Per-Chat Memory and Multi-Turn Sessions
+
+SANDAL provides persistent multi-turn chat memory stored per chat session in `~/.sandal/chats/`:
+
+- **Multi-Turn Context**: Resolves follow-up queries and pronouns (e.g., `"Show top customers"` followed by `"Now count how many of them are active"`).
+- **Query Memory**: Remembers previous queries and schema references within the chat session.
+- **Session Management**:
+  - `.chats` — Displays all saved chat sessions with message counts, titles, and dates.
+  - `.chat <id|num>` — Switches to an existing chat session and reloads its memory.
+  - `.new` — Starts a brand new chat session with clean memory.
+  - `.history` — Reviews the conversation history of the current chat.
+  - `.clear-chat` — Clears message memory for the current session.
+
 ---
 
 ## Safety and Guardrail Architecture