sqlsaber 0.15.0__tar.gz → 0.16.1__tar.gz

sqlsaber-0.16.1/.github/workflows/deploy-docs.yml

@@ -0,0 +1,34 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Allow this job to clone the repo and create a page deployment
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout your repository using git
+        uses: actions/checkout@v4
+      - name: Install, build, and upload your site
+        uses: withastro/action@v3
+        with:
+          path: docs/
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

{sqlsaber-0.15.0 → sqlsaber-0.16.1}/AGENT.md

@@ -11,7 +11,7 @@
 ## Architecture
 
 - **CLI App**: Agentic SQL assistant for natural language to SQL
-- **Core modules**: `agents/` (AI logic), `cli/` (commands), `clients/` (LLM clients), `database/` (connections), `mcp/` (Model Context Protocol server)
+- **Core modules**: `agents/` (AI logic), `cli/` (commands), `database/` (connections), `mcp/` (Model Context Protocol server)
 - **Database support**: PostgreSQL, SQLite, MySQL via asyncpg/aiosqlite/aiomysql
 - **MCP integration**: Exposes tools via `sqlsaber-mcp` for Claude Code and other MCP clients
 
@@ -20,5 +20,5 @@
 - **Imports**: stdlib → 3rd party → local, use relative imports within modules
 - **Naming**: snake_case functions/vars, PascalCase classes, UPPER_SNAKE constants, `_private` methods
 - **Types**: Always use modern type hints (3.12+), async functions for I/O
-- **Errors**: Custom exception hierarchy from `LLMClientError`, use try/finally for cleanup
+- **Errors**: Use try/finally for cleanup
 - **Docstrings**: Triple-quoted with Args/Returns sections

{sqlsaber-0.15.0 → sqlsaber-0.16.1}/CHANGELOG.md

@@ -1,9 +1,40 @@
 # Changelog
 
-All notable changes to SQLSaber will be documented in this file.
+All notable changes to SQLsaber will be documented in this file.
 
 ## [Unreleased]
 
+## [0.16.1] - 2025-09-04
+
+### Added
+
+- Compile python byte code during installation
+- Updated CLI help string
+
+## [0.16.0] - 2025-09-04
+
+### Added
+
+- Migrated to Pydantic-AI agent runtime with model-agnostic interfaces
+- Added multi-provider model support: Anthropic, OpenAI, Google, Groq, Mistral, Cohere, Hugging Face
+- Provider registry tests to ensure invariants and alias normalization
+
+### Changed
+
+- Reworked agents to use new pydantic-ai-based agent implementation
+- Updated CLI modules and settings to integrate provider selection and authentication
+- `saber auth reset` now mirrors setup by prompting for a provider, then selectively removing stored credentials for that provider
+  - Removes API keys from OS credential store for the selected provider
+  - For Anthropic, also detects and removes OAuth tokens
+  - Offers optional prompt to unset global auth method when Anthropic OAuth is removed
+- Centralized provider definitions in `sqlsaber.config.providers` and refactored CLI, config, and agent code to use the registry (single source of truth)
+- Normalized provider aliases (e.g., `google-gla` → `google`) for consistent behavior across modules
+
+### Removed
+
+- Deprecated custom `clients` module and Anthropic-specific client code
+- Removed legacy streaming and events modules and related tests
+
 ## [0.15.0] - 2025-08-18
 
 ### Added

{sqlsaber-0.15.0 → sqlsaber-0.16.1}/CLAUDE.md

@@ -9,7 +9,7 @@
 ## Architecture
 
 - **CLI App**: Agentic SQL assistant for natural language to SQL
-- **Core modules**: `agents/` (AI logic), `cli/` (commands), `clients/` (LLM clients), `database/` (connections), `mcp/` (Model Context Protocol server)
+- **Core modules**: `agents/` (AI logic), `cli/` (commands), `database/` (connections), `mcp/` (Model Context Protocol server)
 - **Database support**: PostgreSQL, SQLite, MySQL via asyncpg/aiosqlite/aiomysql
 - **MCP integration**: Exposes tools via `sqlsaber-mcp` for Claude Code and other MCP clients
 
@@ -18,5 +18,5 @@
 - **Imports**: stdlib → 3rd party → local, use relative imports within modules
 - **Naming**: snake_case functions/vars, PascalCase classes, UPPER_SNAKE constants, `_private` methods
 - **Types**: Always use modern type hints (3.12+), async functions for I/O
-- **Errors**: Custom exception hierarchy from `LLMClientError`, use try/finally for cleanup
+- **Errors**: Use try/finally for cleanup
 - **Docstrings**: Triple-quoted with Args/Returns sections

{sqlsaber-0.15.0 → sqlsaber-0.16.1}/PKG-INFO

@@ -1,12 +1,11 @@
 Metadata-Version: 2.4
 Name: sqlsaber
-Version: 0.15.0
-Summary: SQLSaber - Agentic SQL assistant like Claude Code
+Version: 0.16.1
+Summary: SQLsaber - Open-source agentic SQL assistant
 License-File: LICENSE
 Requires-Python: >=3.12
 Requires-Dist: aiomysql>=0.2.0
 Requires-Dist: aiosqlite>=0.21.0
-Requires-Dist: anthropic>=0.54.0
 Requires-Dist: asyncpg>=0.30.0
 Requires-Dist: cyclopts>=3.22.1
 Requires-Dist: fastmcp>=2.9.0
@@ -14,27 +13,21 @@ Requires-Dist: httpx>=0.28.1
 Requires-Dist: keyring>=25.6.0
 Requires-Dist: pandas>=2.0.0
 Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: pydantic-ai
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: uniplot>=0.21.2
 Description-Content-Type: text/markdown
 
-# SQLSaber
+# SQLsaber
 
-```
-███████  ██████  ██      ███████  █████  ██████  ███████ ██████
-██      ██    ██ ██      ██      ██   ██ ██   ██ ██      ██   ██
-███████ ██    ██ ██      ███████ ███████ ██████  █████   ██████
-     ██ ██ ▄▄ ██ ██           ██ ██   ██ ██   ██ ██      ██   ██
-███████  ██████  ███████ ███████ ██   ██ ██████  ███████ ██   ██
-            ▀▀
-```
+> SQLsaber is an open-source agentic SQL assistant. Think Claude Code but for SQL.
 
-> Use the agent Luke!
+![demo](./sqlsaber.gif)
 
-SQLSaber is an agentic SQL assistant. Think Claude Code but for SQL.
+Stop fighting your database.
 
-Ask your questions in natural language and it will gather the right context automatically and answer your query by writing SQL and analyzing the results.
+Ask your questions in natural language and `sqlsaber` will gather the right context automatically and answer your query by writing SQL and analyzing the results.
 
 ## Table of Contents
 
@@ -59,14 +52,13 @@ Ask your questions in natural language and it will gather the right context auto
 
 ## Features
 
-- Natural language to SQL conversion
 - 🔍 Automatic database schema introspection
 - 🛡️ Safe query execution (read-only by default)
 - 🧠 Memory management
 - 💬 Interactive REPL mode
-- 🎨 Beautiful formatted output with syntax highlighting
 - 🗄️ Support for PostgreSQL, SQLite, and MySQL
 - 🔌 MCP (Model Context Protocol) server support
+- 🎨 Beautiful formatted output
 
 ## Installation
 
@@ -165,34 +157,21 @@ saber -d mydb
 
 # Single query with specific database
 saber -d mydb "count all orders"
+
+# You can also pass a connection string
+saber -d "postgresql://user:password@localhost:5432/mydb" "count all orders"
 ```
 
 ## Examples
 
 ```bash
-# Show database schema
-saber "what tables are in my database?"
-
-# Count records
-saber "how many active users do we have?"
+# Start interactive mode
+saber
 
-# Complex queries with joins
+# Non-interactive mode
 saber "show me orders with customer details for this week"
 
-# Aggregations
-saber "what's the total revenue by product category?"
-
-# Date filtering
-saber "list users who haven't logged in for 30 days"
-
-# Data exploration
-saber "show me the distribution of customer ages"
-
-# Business analytics
 saber "which products had the highest sales growth last quarter?"
-
-# Start interactive mode
-saber
 ```
 
 ## MCP Server Integration
@@ -214,7 +193,7 @@ uvx --from sqlsaber saber-mcp
 Add SQLSaber as an MCP server in Claude Code:
 
 ```bash
-claude mcp add -- uvx --from sqlsaber saber-mcp
+claude mcp add sqlsaber -- uvx --from sqlsaber saber-mcp
 ```
 
 #### Other MCP Clients
@@ -234,7 +213,7 @@ The MCP server uses your existing SQLSaber database configurations, so make sure
 
 ## How It Works
 
-SQLSaber uses a multi-step process to gather the right context, provide it to the model, and execute SQL queries to get the right answers:
+SQLsaber uses a multi-step agentic process to gather the right context and execute SQL queries to answer your questions:
 
 ![](./sqlsaber.svg)
 
@@ -255,7 +234,9 @@ SQLSaber uses a multi-step process to gather the right context, provide it to th
 
 ## Contributing
 
-Contributions are welcome! Please feel free to open an issue to discuss your ideas or report bugs.
+If you like the project, starring the repo is a great way to show your support!
+
+Other contributions are welcome! Please feel free to open an issue to discuss your ideas or report bugs.
 
 ## License
 

{sqlsaber-0.15.0 → sqlsaber-0.16.1}/README.md

@@ -1,19 +1,12 @@
-# SQLSaber
+# SQLsaber
 
-```
-███████  ██████  ██      ███████  █████  ██████  ███████ ██████
-██      ██    ██ ██      ██      ██   ██ ██   ██ ██      ██   ██
-███████ ██    ██ ██      ███████ ███████ ██████  █████   ██████
-     ██ ██ ▄▄ ██ ██           ██ ██   ██ ██   ██ ██      ██   ██
-███████  ██████  ███████ ███████ ██   ██ ██████  ███████ ██   ██
-            ▀▀
-```
+> SQLsaber is an open-source agentic SQL assistant. Think Claude Code but for SQL.
 
-> Use the agent Luke!
+![demo](./sqlsaber.gif)
 
-SQLSaber is an agentic SQL assistant. Think Claude Code but for SQL.
+Stop fighting your database.
 
-Ask your questions in natural language and it will gather the right context automatically and answer your query by writing SQL and analyzing the results.
+Ask your questions in natural language and `sqlsaber` will gather the right context automatically and answer your query by writing SQL and analyzing the results.
 
 ## Table of Contents
 
@@ -38,14 +31,13 @@ Ask your questions in natural language and it will gather the right context auto
 
 ## Features
 
-- Natural language to SQL conversion
 - 🔍 Automatic database schema introspection
 - 🛡️ Safe query execution (read-only by default)
 - 🧠 Memory management
 - 💬 Interactive REPL mode
-- 🎨 Beautiful formatted output with syntax highlighting
 - 🗄️ Support for PostgreSQL, SQLite, and MySQL
 - 🔌 MCP (Model Context Protocol) server support
+- 🎨 Beautiful formatted output
 
 ## Installation
 
@@ -144,34 +136,21 @@ saber -d mydb
 
 # Single query with specific database
 saber -d mydb "count all orders"
+
+# You can also pass a connection string
+saber -d "postgresql://user:password@localhost:5432/mydb" "count all orders"
 ```
 
 ## Examples
 
 ```bash
-# Show database schema
-saber "what tables are in my database?"
-
-# Count records
-saber "how many active users do we have?"
+# Start interactive mode
+saber
 
-# Complex queries with joins
+# Non-interactive mode
 saber "show me orders with customer details for this week"
 
-# Aggregations
-saber "what's the total revenue by product category?"
-
-# Date filtering
-saber "list users who haven't logged in for 30 days"
-
-# Data exploration
-saber "show me the distribution of customer ages"
-
-# Business analytics
 saber "which products had the highest sales growth last quarter?"
-
-# Start interactive mode
-saber
 ```
 
 ## MCP Server Integration
@@ -193,7 +172,7 @@ uvx --from sqlsaber saber-mcp
 Add SQLSaber as an MCP server in Claude Code:
 
 ```bash
-claude mcp add -- uvx --from sqlsaber saber-mcp
+claude mcp add sqlsaber -- uvx --from sqlsaber saber-mcp
 ```
 
 #### Other MCP Clients
@@ -213,7 +192,7 @@ The MCP server uses your existing SQLSaber database configurations, so make sure
 
 ## How It Works
 
-SQLSaber uses a multi-step process to gather the right context, provide it to the model, and execute SQL queries to get the right answers:
+SQLsaber uses a multi-step agentic process to gather the right context and execute SQL queries to answer your questions:
 
 ![](./sqlsaber.svg)
 
@@ -234,7 +213,9 @@ SQLSaber uses a multi-step process to gather the right context, provide it to th
 
 ## Contributing
 
-Contributions are welcome! Please feel free to open an issue to discuss your ideas or report bugs.
+If you like the project, starring the repo is a great way to show your support!
+
+Other contributions are welcome! Please feel free to open an issue to discuss your ideas or report bugs.
 
 ## License
 

sqlsaber-0.16.1/docs/.gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/

sqlsaber-0.16.1/docs/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

sqlsaber-0.16.1/docs/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

sqlsaber-0.16.1/docs/CLAUDE.md

@@ -0,0 +1,40 @@
+## Commands
+
+- **Start dev server**: `npm run dev`
+- **Build for production**: `npm run build`
+- **Preview production build**: `npm run preview`
+- **Run Astro CLI**: `npm run astro`
+- **Add new shadcn-svelte component**: `npx shadcn-svelte@latest add <ComponentName>`
+
+## Architecture
+
+This is the documentation website for SQLSaber, built with:
+
+- **Astro**: Static site generator with hybrid SSG/SSR capabilities
+- **Svelte**: Component framework for interactive UI elements
+- **shadcn-svelte**: Pre-built component library with Tailwind CSS
+- **TypeScript**: Full type safety across the codebase
+
+### Project Structure
+
+- `src/pages/`: Astro pages that define routes
+- `src/lib/components/ui/`: shadcn-svelte UI components
+- `src/lib/styles/`: Global CSS and Tailwind configuration
+- `src/lib/utils.ts`: Utility functions for component styling
+- `public/`: Static assets served directly
+
+### Key Configuration Files
+
+- `astro.config.mjs`: Astro configuration with Svelte integration
+- `components.json`: shadcn-svelte component configuration
+- `tsconfig.json`: TypeScript configuration with path aliases
+- `svelte.config.js`: Svelte preprocessing configuration
+
+## Development Guidelines
+
+- Use `$lib/*` path aliases for importing from `src/lib/`
+- Follow shadcn-svelte component patterns for UI consistency. If needed, feel free to add new shadcn-svelte components.
+- Astro pages use `.astro` extension, components use `.svelte` unless you create Astro components
+- When using Svelte, exclusively use Svelte 5 syntax only
+- Follow Astro 5 best practices for splitting pages and components wherever appropriate
+- CSS-in-JS via Tailwind classes, global styles in `src/lib/styles/app.css`

sqlsaber-0.16.1/docs/astro.config.mjs

@@ -0,0 +1,17 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+
+import svelte from '@astrojs/svelte';
+
+import tailwindcss from '@tailwindcss/vite';
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [svelte()],
+
+  vite: {
+    plugins: [tailwindcss()]
+  },
+
+  site: 'https://sqlsaber.com'
+});

sqlsaber-0.16.1/docs/components.json

@@ -0,0 +1,16 @@
+{
+	"$schema": "https://shadcn-svelte.com/schema.json",
+	"tailwind": {
+		"css": "src/styles/app.css",
+		"baseColor": "slate"
+	},
+	"aliases": {
+		"components": "$lib/components",
+		"utils": "$lib/utils",
+		"ui": "$lib/components/ui",
+		"hooks": "$lib/hooks",
+		"lib": "$lib"
+	},
+	"typescript": true,
+	"registry": "https://shadcn-svelte.com/registry"
+}