sqlsaber 0.4.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

sqlsaber/agents/anthropic.py

@@ -82,6 +82,44 @@ class AnthropicSQLAgent(BaseSQLAgent):
                     "required": ["query"],
                 },
             },
+            {
+                "name": "plot_data",
+                "description": "Create a plot of query results.",
+                "input_schema": {
+                    "type": "object",
+                    "properties": {
+                        "y_values": {
+                            "type": "array",
+                            "items": {"type": ["number", "null"]},
+                            "description": "Y-axis data points (required)",
+                        },
+                        "x_values": {
+                            "type": "array",
+                            "items": {"type": ["number", "null"]},
+                            "description": "X-axis data points (optional, will use indices if not provided)",
+                        },
+                        "plot_type": {
+                            "type": "string",
+                            "enum": ["line", "scatter", "histogram"],
+                            "description": "Type of plot to create (default: line)",
+                            "default": "line",
+                        },
+                        "title": {
+                            "type": "string",
+                            "description": "Title for the plot",
+                        },
+                        "x_label": {
+                            "type": "string",
+                            "description": "Label for X-axis",
+                        },
+                        "y_label": {
+                            "type": "string",
+                            "description": "Label for Y-axis",
+                        },
+                    },
+                    "required": ["y_values"],
+                },
+            },
         ]
 
         # Build system prompt with memories if available
@@ -96,13 +134,15 @@ Your responsibilities:
 1. Understand user's natural language requests, think and convert them to SQL
 2. Use the provided tools efficiently to explore database schema
 3. Generate appropriate SQL queries
-4. Execute queries safely (only SELECT queries unless explicitly allowed)
+4. Execute queries safely - queries that modify the database are not allowed
 5. Format and explain results clearly
+6. Create visualizations when requested or when they would be helpful
 
 IMPORTANT - Schema Discovery Strategy:
 1. ALWAYS start with 'list_tables' to see available tables and row counts
 2. Based on the user's query, identify which specific tables are relevant
 3. Use 'introspect_schema' with a table_pattern to get details ONLY for relevant tables
+4. Timestamp columns must be converted to text when you write queries
 
 Guidelines:
 - Use list_tables first, then introspect_schema for specific tables only
@@ -249,6 +289,15 @@ Guidelines:
                             "result": tool_result,
                         },
                     )
+                elif block["name"] == "plot_data":
+                    yield StreamEvent(
+                        "plot_result",
+                        {
+                            "tool_name": block["name"],
+                            "input": block["input"],
+                            "result": tool_result,
+                        },
+                    )
 
                 tool_results.append(build_tool_result_block(block["id"], tool_result))
 

sqlsaber/agents/base.py

@@ -4,6 +4,8 @@ import json
 from abc import ABC, abstractmethod
 from typing import Any, AsyncIterator, Dict, List, Optional
 
+from uniplot import histogram, plot
+
 from sqlsaber.database.connection import (
     BaseDatabaseConnection,
     CSVConnection,
@@ -146,6 +148,15 @@ class BaseSQLAgent(ABC):
             return await self.execute_sql(
                 tool_input["query"], tool_input.get("limit", 100)
             )
+        elif tool_name == "plot_data":
+            return await self.plot_data(
+                y_values=tool_input["y_values"],
+                x_values=tool_input.get("x_values"),
+                plot_type=tool_input.get("plot_type", "line"),
+                title=tool_input.get("title"),
+                x_label=tool_input.get("x_label"),
+                y_label=tool_input.get("y_label"),
+            )
         else:
             return json.dumps({"error": f"Unknown tool: {tool_name}"})
 
@@ -182,3 +193,84 @@ class BaseSQLAgent(ABC):
         if query_upper.startswith("SELECT") and "LIMIT" not in query_upper:
             return f"{query.rstrip(';')} LIMIT {limit};"
         return query
+
+    async def plot_data(
+        self,
+        y_values: List[float],
+        x_values: Optional[List[float]] = None,
+        plot_type: str = "line",
+        title: Optional[str] = None,
+        x_label: Optional[str] = None,
+        y_label: Optional[str] = None,
+    ) -> str:
+        """Create a terminal plot using uniplot.
+
+        Args:
+            y_values: Y-axis data points
+            x_values: X-axis data points (optional)
+            plot_type: Type of plot - "line", "scatter", or "histogram"
+            title: Plot title
+            x_label: X-axis label
+            y_label: Y-axis label
+
+        Returns:
+            JSON string with success status and plot details
+        """
+        try:
+            # Validate inputs
+            if not y_values:
+                return json.dumps({"error": "No data provided for plotting"})
+
+            # Convert to floats if needed
+            try:
+                y_values = [float(v) if v is not None else None for v in y_values]
+                if x_values:
+                    x_values = [float(v) if v is not None else None for v in x_values]
+            except (ValueError, TypeError) as e:
+                return json.dumps({"error": f"Invalid data format: {str(e)}"})
+
+            # Create the plot
+            if plot_type == "histogram":
+                # For histogram, we only need y_values
+                histogram(
+                    y_values,
+                    title=title,
+                    bins=min(20, len(set(y_values))),  # Adaptive bin count
+                )
+                plot_info = {
+                    "type": "histogram",
+                    "data_points": len(y_values),
+                    "title": title or "Histogram",
+                }
+            elif plot_type in ["line", "scatter"]:
+                # For line/scatter plots
+                plot_kwargs = {
+                    "ys": y_values,
+                    "title": title,
+                    "lines": plot_type == "line",
+                }
+
+                if x_values:
+                    plot_kwargs["xs"] = x_values
+                if x_label:
+                    plot_kwargs["x_unit"] = x_label
+                if y_label:
+                    plot_kwargs["y_unit"] = y_label
+
+                plot(**plot_kwargs)
+
+                plot_info = {
+                    "type": plot_type,
+                    "data_points": len(y_values),
+                    "title": title or f"{plot_type.capitalize()} Plot",
+                    "has_x_values": x_values is not None,
+                }
+            else:
+                return json.dumps({"error": f"Unsupported plot type: {plot_type}"})
+
+            return json.dumps(
+                {"success": True, "plot_rendered": True, "plot_info": plot_info}
+            )
+
+        except Exception as e:
+            return json.dumps({"error": f"Error creating plot: {str(e)}"})

sqlsaber/cli/commands.py

@@ -117,6 +117,9 @@ def query(
             if query_text:
                 # Single query mode with streaming
                 streaming_handler = StreamingQueryHandler(console)
+                console.print(
+                    f"[bold blue]Connected to:[/bold blue] {db_name} {agent._get_database_type_name()}\n"
+                )
                 await streaming_handler.execute_streaming_query(query_text, agent)
             else:
                 # Interactive mode

sqlsaber/cli/display.py

@@ -205,3 +205,33 @@ class DisplayManager:
             self.show_error("Failed to parse schema data")
         except Exception as e:
             self.show_error(f"Error displaying schema information: {str(e)}")
+
+    def show_plot(self, plot_data: dict):
+        """Display plot information and status."""
+        try:
+            # Parse the result if it's a string
+            if isinstance(plot_data.get("result"), str):
+                result = json.loads(plot_data["result"])
+            else:
+                result = plot_data.get("result", {})
+
+            # Check if there was an error
+            if "error" in result:
+                self.show_error(f"Plot error: {result['error']}")
+                return
+
+            # If plot was successful, show plot info
+            if result.get("success") and result.get("plot_rendered"):
+                plot_info = result.get("plot_info", {})
+                self.console.print(
+                    f"\n[bold green]✓ Plot rendered:[/bold green] {plot_info.get('title', 'Plot')}"
+                )
+                self.console.print(
+                    f"[dim]  Type: {plot_info.get('type', 'unknown')}, "
+                    f"Data points: {plot_info.get('data_points', 0)}[/dim]"
+                )
+
+        except json.JSONDecodeError:
+            self.show_error("Failed to parse plot result")
+        except Exception as e:
+            self.show_error(f"Error displaying plot: {str(e)}")

sqlsaber/cli/interactive.py

@@ -20,21 +20,24 @@ class InteractiveSession:
 
     def show_welcome_message(self):
         """Display welcome message for interactive mode."""
+        # Show database information
+        db_name = getattr(self.agent, "database_name", None) or "Unknown"
+        db_type = self.agent._get_database_type_name()
+
         self.console.print(
             Panel.fit(
                 "[bold green]SQLSaber - Use the agent Luke![/bold green]\n\n"
-                "Type your queries in natural language.\n\n"
-                "Press Esc-Enter or Meta-Enter to submit your query.\n\n"
-                "Type 'exit' or 'quit' to leave.",
+                "[bold]Your agentic SQL assistant.[/bold]\n\n\n"
+                "[dim]Use 'clear' to reset conversation, 'exit' or 'quit' to leave.[/dim]\n\n"
+                "[dim]Start a message with '#' to add something to agent's memory for this database.[/dim]",
                 border_style="green",
             )
         )
-
         self.console.print(
-            "[dim]Commands: 'clear' to reset conversation, 'exit' or 'quit' to leave[/dim]"
+            f"[bold blue]Connected to:[/bold blue] {db_name} ({db_type})\n"
         )
         self.console.print(
-            "[dim]Memory: Start a message with '#' to add it as a memory for this database[/dim]\n"
+            "[dim]Press Esc-Enter or Meta-Enter to submit your query.[/dim]\n"
         )
 
     async def run(self):

sqlsaber/cli/streaming.py

@@ -63,6 +63,11 @@ class StreamingQueryHandler:
                         self.display.show_schema_info(event.data["result"])
                         has_content = True
 
+                elif event.type == "plot_result":
+                    # Handle plot results
+                    self.display.show_plot(event.data)
+                    has_content = True
+
                 elif event.type == "processing":
                     # Show status when processing tool results
                     if explanation_started:

sqlsaber/models/events.py

@@ -7,7 +7,7 @@ class StreamEvent:
     """Event emitted during streaming processing."""
 
     def __init__(self, event_type: str, data: Any = None):
-        # 'tool_use', 'text', 'query_result', 'error', 'processing'
+        # 'tool_use', 'text', 'query_result', 'plot_result', 'error', 'processing'
         self.type = event_type
         self.data = data
 

{sqlsaber-0.4.0.dist-info → sqlsaber-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlsaber
-Version: 0.4.0
+Version: 0.5.0
 Summary: SQLSaber - Agentic SQL assistant like Claude Code
 License-File: LICENSE
 Requires-Python: >=3.12
@@ -16,6 +16,7 @@ Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: questionary>=2.1.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: typer>=0.16.0
+Requires-Dist: uniplot>=0.21.2
 Description-Content-Type: text/markdown
 
 # SQLSaber
@@ -24,7 +25,28 @@ Description-Content-Type: text/markdown
 
 SQLSaber is an agentic SQL assistant. Think Claude Code but for SQL.
 
-Ask your questions in natural language and it will gather the right context and answer your query by writing SQL and analyzing the results.
+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.
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Configuration](#configuration)
+  - [Database Connection](#database-connection)
+  - [AI Model Configuration](#ai-model-configuration)
+  - [Memory Management](#memory-management)
+- [Usage](#usage)
+  - [Interactive Mode](#interactive-mode)
+  - [Single Query](#single-query)
+  - [Database Selection](#database-selection)
+- [Examples](#examples)
+- [MCP Server Integration](#mcp-server-integration)
+  - [Starting the MCP Server](#starting-the-mcp-server)
+  - [Configuring MCP Clients](#configuring-mcp-clients)
+  - [Available MCP Tools](#available-mcp-tools)
+- [How It Works](#how-it-works)
+- [Contributing](#contributing)
+- [License](#license)
 
 ## Features
 
@@ -39,16 +61,25 @@ Ask your questions in natural language and it will gather the right context and
 
 ## Installation
 
+### `uv`
+
 ```bash
 uv tool install sqlsaber
 ```
 
-or
+### `pipx`
 
 ```bash
 pipx install sqlsaber
 ```
 
+### `brew`
+
+```bash
+brew install uv
+uv tool install sqlsaber
+```
+
 ## Configuration
 
 ### Database Connection
@@ -151,7 +182,7 @@ SQLSaber includes an MCP (Model Context Protocol) server that allows AI agents l
 Run the MCP server using uvx:
 
 ```bash
-uvx saber-mcp
+uvx --from sqlsaber saber-mcp
 ```
 
 ### Configuring MCP Clients
@@ -161,12 +192,12 @@ uvx saber-mcp
 Add SQLSaber as an MCP server in Claude Code:
 
 ```bash
-claude mcp add -- uvx saber-mcp
+claude mcp add -- uvx --from sqlsaber saber-mcp
 ```
 
 #### Other MCP Clients
 
-For other MCP clients, configure them to run the command: `uvx saber-mcp`
+For other MCP clients, configure them to run the command: `uvx --from sqlsaber saber-mcp`
 
 ### Available MCP Tools
 

{sqlsaber-0.4.0.dist-info → sqlsaber-0.5.0.dist-info}/RECORD

@@ -1,18 +1,18 @@
 sqlsaber/__init__.py,sha256=QCFi8xTVMohelfi7zOV1-6oLCcGoiXoOcKQY-HNBCk8,66
 sqlsaber/__main__.py,sha256=RIHxWeWh2QvLfah-2OkhI5IJxojWfy4fXpMnVEJYvxw,78
 sqlsaber/agents/__init__.py,sha256=LWeSeEUE4BhkyAYFF3TE-fx8TtLud3oyEtyB8ojFJgo,167
-sqlsaber/agents/anthropic.py,sha256=xAjKeQSnaut-P5VBeBISbQeqdP41epDjX6MJb2ZUXWg,14060
-sqlsaber/agents/base.py,sha256=IuVyCaA7VsA92odfQS2_lYNzwIZwPxK55mL_xRewgwQ,6943
+sqlsaber/agents/anthropic.py,sha256=HxpMV5uiOmxPAUR-ZZw8ncK7lM0aCUvj8mLiyFaUFwE,16268
+sqlsaber/agents/base.py,sha256=IYVYYdQgSOQV6o1_3bzOizRuVMDw_aXfiPdFMNHwpg0,10269
 sqlsaber/agents/mcp.py,sha256=FKtXgDrPZ2-xqUYCw2baI5JzrWekXaC5fjkYW1_Mg50,827
 sqlsaber/agents/streaming.py,sha256=_EO390-FHUrL1fRCNfibtE9QuJz3LGQygbwG3CB2ViY,533
 sqlsaber/cli/__init__.py,sha256=qVSLVJLLJYzoC6aj6y9MFrzZvAwc4_OgxU9DlkQnZ4M,86
-sqlsaber/cli/commands.py,sha256=h418lgh_Xp7XEQ1xvjcDyplC2JON0-y98QMaDm6o29k,4919
+sqlsaber/cli/commands.py,sha256=Dw24W0jij-8t1lpk99C4PBTgzFSag6vU-FZcjAYGG54,5074
 sqlsaber/cli/database.py,sha256=DUfyvNBDp47oFM_VAC_hXHQy_qyE7JbXtowflJpwwH8,12643
-sqlsaber/cli/display.py,sha256=5J4AgJADmMwKi9Aq5u6_MKRO1TA6unS4F4RUfml_sfU,7651
-sqlsaber/cli/interactive.py,sha256=y92rdoM49SOSwEctm9ZcrEN220fhJ_DMHPSd_7KsORg,3701
+sqlsaber/cli/display.py,sha256=LhsUSAFbiPBQRtW2JFf8PnpDnF2_kYdVTsB9HYgvxT4,8888
+sqlsaber/cli/interactive.py,sha256=Kqe7kN9mhUiY_5z1Ki6apZ9ahs8uzhHp3xMZGiyTXpY,3912
 sqlsaber/cli/memory.py,sha256=LW4ZF2V6Gw6hviUFGZ4ym9ostFCwucgBTIMZ3EANO-I,7671
 sqlsaber/cli/models.py,sha256=3IcXeeU15IQvemSv-V-RQzVytJ3wuQ4YmWk89nTDcSE,7813
-sqlsaber/cli/streaming.py,sha256=5QGAYTAvg9mzQLxDEVtdDH-TIbGfYYzMOLoOYPrHPu0,3788
+sqlsaber/cli/streaming.py,sha256=EpltnkdokN42bczULbP9u_t8zduwhGyV-TWm1h8H-jc,3975
 sqlsaber/config/__init__.py,sha256=olwC45k8Nc61yK0WmPUk7XHdbsZH9HuUAbwnmKe3IgA,100
 sqlsaber/config/api_keys.py,sha256=kLdoExF_My9ojmdhO5Ca7-ZeowsO0v1GVa_QT5jjUPo,3658
 sqlsaber/config/database.py,sha256=vKFOxPjVakjQhj1uoLcfzhS9ZFr6Z2F5b4MmYALQZoA,11421
@@ -26,10 +26,10 @@ sqlsaber/memory/__init__.py,sha256=GiWkU6f6YYVV0EvvXDmFWe_CxarmDCql05t70MkTEWs,6
 sqlsaber/memory/manager.py,sha256=ML2NEO5Z4Aw36sEI9eOvWVnjl-qT2VOTojViJAj7Seo,2777
 sqlsaber/memory/storage.py,sha256=DvZBsSPaAfk_DqrNEn86uMD-TQsWUI6rQLfNw6PSCB8,5788
 sqlsaber/models/__init__.py,sha256=RJ7p3WtuSwwpFQ1Iw4_DHV2zzCtHqIzsjJzxv8kUjUE,287
-sqlsaber/models/events.py,sha256=55m41tDwMsFxnKKA5_VLJz8iV-V4Sq3LDfta4VoutJI,737
+sqlsaber/models/events.py,sha256=q2FackB60J9-7vegYIjzElLwKebIh7nxnV5AFoZc67c,752
 sqlsaber/models/types.py,sha256=3U_30n91EB3IglBTHipwiW4MqmmaA2qfshfraMZyPps,896
-sqlsaber-0.4.0.dist-info/METADATA,sha256=CL1mNjOLrc6VDJqE2dSrCXO5OJz9gTMxYNoYq6jtzYE,5071
-sqlsaber-0.4.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sqlsaber-0.4.0.dist-info/entry_points.txt,sha256=jmFo96Ylm0zIKXJBwhv_P5wQ7SXP9qdaBcnTp8iCEe8,195
-sqlsaber-0.4.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-sqlsaber-0.4.0.dist-info/RECORD,,
+sqlsaber-0.5.0.dist-info/METADATA,sha256=npxser6DO4GaHpYKsdcHvosseRr7RU0pZ0c81h2t2KA,5969
+sqlsaber-0.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sqlsaber-0.5.0.dist-info/entry_points.txt,sha256=jmFo96Ylm0zIKXJBwhv_P5wQ7SXP9qdaBcnTp8iCEe8,195
+sqlsaber-0.5.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+sqlsaber-0.5.0.dist-info/RECORD,,