dbagent-cli 0.11.4__tar.gz → 0.11.5__tar.gz

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbagent-cli
-Version: 0.11.4
+Version: 0.11.5
 Summary: The Privacy-First AI Database Copilot, Schema Graph Introspector & Post-Commit Recovery Engine (CLI)
 Author: Santhosh Gupta
 License: MIT

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/dbagent/__init__.py

@@ -2,5 +2,5 @@
 DB-Agent: Universal Database Introspection and Script Generation AI Agent (CLI).
 """
 
-__version__ = "0.11.4"
+__version__ = "0.11.5"
 __author__ = "Santhosh Gupta"

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/dbagent/cli.py

@@ -27,6 +27,7 @@ from prompt_toolkit import PromptSession, HTML
 from prompt_toolkit.history import FileHistory
 from prompt_toolkit.completion import WordCompleter
 from prompt_toolkit.styles import Style
+from prompt_toolkit.key_binding import KeyBindings
 
 from dbagent import __version__, __author__
 from dbagent.config import ConfigManager
@@ -73,6 +74,7 @@ from dbagent.ui.console import (
 )
 from dbagent.ui.viewer import SchemaViewer
 from dbagent.ui.grid_window import open_desktop_grid_window, open_browser_grid_window
+from dbagent.ui.clipboard import ClipboardManager
 from dbagent.ui.chat_screen import (
     clear_screen,
     render_chat_header,
@@ -625,6 +627,45 @@ def ask_command(
         raise typer.Exit(1)
 
 
+def open_multiline_paste_session() -> Optional[str]:
+    """
+    Opens an interactive multiline editing / paste buffer for long SQL scripts or complex prompts.
+    Submit: Type ';;' on an empty line, or press Esc+Enter / Alt+Enter.
+    Cancel: Press Ctrl+C.
+    """
+    console.print("\n[bold cyan]📋 Multiline Paste & Edit Mode[/bold cyan]")
+    console.print("[dim]Paste your multiline SQL or instructions below.[/dim]")
+    console.print("[dim]Submit: Type [bold white];;[/bold white] on a new line or press [bold white]Esc+Enter[/bold white] · Cancel: [bold white]Ctrl+C[/bold white]\n[/dim]")
+
+    kb = KeyBindings()
+
+    @kb.add("escape", "enter")
+    def _submit(event):
+        event.current_buffer.validate_and_handle()
+
+    try:
+        multi_style = Style.from_dict({
+            "prompt": "#06b6d4 bold",
+        })
+        multi_session = PromptSession(
+            key_bindings=kb,
+            multiline=True,
+            enable_bracketed_paste=True,
+            style=multi_style,
+        )
+        text = multi_session.prompt(
+            HTML("<ansicyan><b>... </b></ansicyan>"),
+            prompt_continuation=lambda width, line_number, is_soft_wrap: "... ",
+        )
+        clean = text.strip()
+        if clean.endswith(";;"):
+            clean = clean[:-2].strip()
+        return clean if clean else None
+    except (KeyboardInterrupt, EOFError):
+        console.print("[dim italic]Multiline input cancelled.[/dim italic]\n")
+        return None
+
+
 # ---- chat (interactive REPL) ----
 
 @app.command(name="chat")
@@ -686,6 +727,7 @@ def chat_command(
     chat_completer = WordCompleter([
         ":help", ":tables", ":schema", ":dt", ":table", ":fk", ":path", ":join",
         ":doctor", ":mode", ":changes", ":provider", ":model", ":models",
+        ":copy", ":cp", ":c", ":paste", ":p", ":multiline", ":paste-mode", ":m",
         ":page", ":card", ":wide", ":scroll", ":window", ":grid", ":web",
         ":explain", ":history", ":queue", ":auto", ":noauto", ":run", ":clear", ":export",
         ":exit", ":quit", ":q",
@@ -697,16 +739,29 @@ def chat_command(
         "bottom-toolbar.cyan": "#06b6d4 bold",
         "bottom-toolbar.yellow": "#f59e0b bold",
     })
+
+    kb = KeyBindings()
+
+    @kb.add("escape", "v")
+    def _kb_paste_clipboard(event):
+        """Alt+V / Esc, V shortcut: paste clipboard text into current buffer."""
+        text, _ = ClipboardManager.get_text()
+        if text:
+            event.current_buffer.insert_text(text)
+
     session = PromptSession(
         history=FileHistory(str(history_file)),
         completer=chat_completer,
         style=chat_style,
+        key_bindings=kb,
+        enable_bracketed_paste=True,
     )
 
     auto_execute = True
     conversation_ctx = ConversationContext()
     query_history: List[PipelineResult] = []
     last_result: Optional[PipelineResult] = None
+    last_user_prompt: str = ""
 
     from dbagent.execution.prompt_queue import PromptQueueManager
     prompt_queue = PromptQueueManager(console=console)
@@ -785,6 +840,9 @@ def chat_command(
                     cmd_table.add_row(":learn <rule>", "Teach DB-Agent custom domain rules & mappings (:learn topic = rule)")
                     cmd_table.add_row(":memory, :learned", "View all learned domain rules & relationship memory")
                     cmd_table.add_row(":forget <id|topic>", "Remove a learned rule from persistent memory")
+                    cmd_table.add_row(":copy [format]", "Copy SQL, CSV, TSV (Excel), JSON, Markdown or INSERTs to clipboard")
+                    cmd_table.add_row(":paste, :p", "Paste and execute SQL or prompt directly from system clipboard")
+                    cmd_table.add_row(":multiline, :m", "Open multiline paste mode for long SQL blocks (Esc+Enter / ;;)")
                     cmd_table.add_row(":mode <name>", "Switch safety mode (SAFE, CONFIRM, ADMIN, READ_ONLY)")
                     cmd_table.add_row(":history", "View session query history, execution timing & row counts")
                     cmd_table.add_row(":queue, :q-list", "View queued in-line prompts (:queue clear to reset)")
@@ -1124,7 +1182,123 @@ def chat_command(
                     )
                     continue
 
-                if cmd_name in [":page", ":cols", ":p"]:
+                if cmd_name in [":copy", ":cp", ":c"]:
+                    target = cmd_arg.strip().lower() if cmd_arg else "sql"
+                    if target in ["sql", "query", "code"]:
+                        if not last_result or not last_result.sql:
+                            print_warning("No generated SQL query to copy.")
+                            continue
+                        ok, msg = ClipboardManager.copy_text(last_result.sql.strip())
+                        if ok:
+                            print_success(f"Copied SQL query to clipboard! ({len(last_result.sql.strip())} chars)")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["csv", "comma"]:
+                        if not last_result or not last_result.rows:
+                            print_warning("No query result rows to copy.")
+                            continue
+                        formatted = ClipboardManager.format_results_as(last_result.columns, last_result.rows, format_type="csv")
+                        ok, msg = ClipboardManager.copy_text(formatted)
+                        if ok:
+                            print_success(f"Copied {len(last_result.rows)} row(s) as CSV to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["tsv", "excel", "sheets", "tab"]:
+                        if not last_result or not last_result.rows:
+                            print_warning("No query result rows to copy.")
+                            continue
+                        formatted = ClipboardManager.format_results_as(last_result.columns, last_result.rows, format_type="tsv")
+                        ok, msg = ClipboardManager.copy_text(formatted)
+                        if ok:
+                            print_success(f"Copied {len(last_result.rows)} row(s) as TSV to clipboard (ready for Excel/Sheets)!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["json", "js"]:
+                        if not last_result or not last_result.rows:
+                            print_warning("No query result rows to copy.")
+                            continue
+                        formatted = ClipboardManager.format_results_as(last_result.columns, last_result.rows, format_type="json")
+                        ok, msg = ClipboardManager.copy_text(formatted)
+                        if ok:
+                            print_success(f"Copied {len(last_result.rows)} row(s) as JSON to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["md", "markdown", "table"]:
+                        if not last_result or not last_result.rows:
+                            print_warning("No query result rows to copy.")
+                            continue
+                        formatted = ClipboardManager.format_results_as(last_result.columns, last_result.rows, format_type="md")
+                        ok, msg = ClipboardManager.copy_text(formatted)
+                        if ok:
+                            print_success(f"Copied {len(last_result.rows)} row(s) as Markdown table to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["insert", "inserts", "sql-insert"]:
+                        if not last_result or not last_result.rows:
+                            print_warning("No query result rows to copy.")
+                            continue
+                        tbl = last_result.exact_tables[0] if (last_result.exact_tables) else "query_results"
+                        formatted = ClipboardManager.format_results_as(last_result.columns, last_result.rows, format_type="sql", table_name=tbl)
+                        ok, msg = ClipboardManager.copy_text(formatted)
+                        if ok:
+                            print_success(f"Copied {len(last_result.rows)} SQL INSERT statement(s) to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["prompt", "question", "ask"]:
+                        if not last_user_prompt:
+                            print_warning("No previous prompt to copy.")
+                            continue
+                        ok, msg = ClipboardManager.copy_text(last_user_prompt)
+                        if ok:
+                            print_success("Copied last prompt to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    elif target in ["history", "all-sql"]:
+                        sqls = [r.sql.strip() for r in query_history if r.sql]
+                        if not sqls:
+                            print_warning("No SQL queries in session history to copy.")
+                            continue
+                        joined = ";\n\n".join(sqls) + ";"
+                        ok, msg = ClipboardManager.copy_text(joined)
+                        if ok:
+                            print_success(f"Copied {len(sqls)} SQL statement(s) from session history to clipboard!")
+                        else:
+                            print_error(f"Clipboard copy failed: {msg}")
+                    else:
+                        print_warning(f"Unknown copy format '{target}'. Available: :copy sql, :copy csv, :copy tsv (Excel), :copy json, :copy md, :copy insert, :copy prompt, :copy history")
+                    continue
+
+                if cmd_name in [":paste", ":p"]:
+                    pasted_text, p_msg = ClipboardManager.get_text()
+                    if not pasted_text or not pasted_text.strip():
+                        print_warning("Clipboard is empty or could not be read.")
+                        continue
+                    pasted_clean = pasted_text.strip()
+                    console.print(f"\n[bold cyan]📋 Pasted from clipboard ({len(pasted_clean):,} chars):[/bold cyan]")
+                    if "\n" in pasted_clean or len(pasted_clean) > 80:
+                        if any(pasted_clean.lower().startswith(kw) for kw in ["select", "insert", "update", "delete", "create", "alter", "drop", "with", "explain"]):
+                            from rich.syntax import Syntax
+                            console.print(Panel(Syntax(pasted_clean, "sql", theme="monokai", line_numbers=False), border_style="cyan", padding=(0, 1)))
+                        else:
+                            console.print(Panel(pasted_clean, border_style="cyan", padding=(0, 1)))
+                    else:
+                        console.print(f"  [bold white]{pasted_clean}[/bold white]\n")
+
+                    user_input = pasted_clean
+                    if user_input.startswith(":"):
+                        prompt_queue.split_and_enqueue_chained(user_input)
+                        continue
+
+                elif cmd_name in [":multiline", ":paste-mode", ":m"]:
+                    multiline_input = open_multiline_paste_session()
+                    if not multiline_input:
+                        continue
+                    user_input = multiline_input
+                    if user_input.startswith(":"):
+                        prompt_queue.split_and_enqueue_chained(user_input)
+                        continue
+
+                elif cmd_name in [":page", ":cols"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to page.")
                         continue
@@ -1135,21 +1309,21 @@ def chat_command(
                     print_results_table(last_result.columns, last_result.rows, title="Results", col_page=p_num)
                     continue
 
-                if cmd_name in [":card", ":vertical", ":x", ":v"]:
+                elif cmd_name in [":card", ":vertical", ":x", ":v"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to display.")
                         continue
                     print_results_vertical(last_result.columns, last_result.rows)
                     continue
 
-                if cmd_name in [":wide", ":all", ":raw"]:
+                elif cmd_name in [":wide", ":all", ":raw"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to display.")
                         continue
                     print_results_table(last_result.columns, last_result.rows, title="All Columns (Wide View)", show_all=True)
                     continue
 
-                if cmd_name in [":window", ":gui", ":grid", ":w"]:
+                elif cmd_name in [":window", ":gui", ":grid", ":w"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to display.")
                         continue
@@ -1157,7 +1331,7 @@ def chat_command(
                     open_desktop_grid_window(last_result.columns, last_result.rows, title=f"DB-Agent Data Grid")
                     continue
 
-                if cmd_name in [":web", ":browser", ":html"]:
+                elif cmd_name in [":web", ":browser", ":html"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to display.")
                         continue
@@ -1165,24 +1339,24 @@ def chat_command(
                     open_browser_grid_window(last_result.columns, last_result.rows, title=f"DB-Agent Data View")
                     continue
 
-                if cmd_name in [":scroll", ":scroller", ":pager"]:
+                elif cmd_name in [":scroll", ":scroller", ":pager"]:
                     if not last_result or not last_result.rows:
                         print_warning("No previous query results to scroll.")
                         continue
                     open_interactive_scroller(last_result.columns, last_result.rows)
                     continue
 
-                if cmd_name == ":auto":
+                elif cmd_name == ":auto":
                     auto_execute = True
                     print_success("Auto-execute enabled. Read queries will run automatically.")
                     continue
 
-                if cmd_name == ":noauto":
+                elif cmd_name == ":noauto":
                     auto_execute = False
                     print_info("Auto-execute disabled. All queries will show SQL only. Use :run to execute.")
                     continue
 
-                if cmd_name == ":run":
+                elif cmd_name == ":run":
                     if not last_result or not last_result.sql:
                         print_warning("No generated SQL query to run.")
                         continue
@@ -1195,7 +1369,7 @@ def chat_command(
                         print_results_table(cols, rows)
                     continue
 
-                if cmd_name == ":export":
+                elif cmd_name == ":export":
                     if not cmd_arg:
                         print_warning("Usage: :export <file_path> (e.g. :export query.sql)")
                         continue
@@ -1208,13 +1382,16 @@ def chat_command(
                     print_success(f"SQL saved to {p}")
                     continue
 
-                print_warning(f"Unknown command '{user_input}'. Type [bold]:help[/bold] to see all in-chat commands.")
-                continue
+                else:
+                    print_warning(f"Unknown command '{user_input}'. Type [bold]:help[/bold] to see all in-chat commands.")
+                    continue
 
             if user_input.lower() in ["exit", "quit", "q"]:
                 console.print("[bold cyan]Goodbye![/bold cyan]")
                 break
 
+            last_user_prompt = user_input
+
             # --- Natural language query via pipeline with live streaming & background queue listener ---
             pipeline.model = model
             pipeline.mode = current_mode

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/dbagent/ui/chat_screen.py

@@ -60,12 +60,13 @@ def render_chat_header(
     right_grid.add_column()
     right_grid.add_row("[bold cyan]💡 Quick Database Tips[/bold cyan]")
     right_grid.add_row("[dim]Ask in plain English or paste direct SQL for 0ms execution[/dim]")
+    right_grid.add_row("[dim]Copy results: [bold white]:copy[/bold white] (SQL), [bold white]:copy csv[/bold white], [bold white]:copy tsv[/bold white] (Excel) · Paste: [bold white]:paste[/bold white][/dim]")
     right_grid.add_row("[dim]Type :help to inspect tables (:tables), relations (:fk), or diagnostics (:doctor)[/dim]")
     right_grid.add_row("[dim]────────────────────────────────────────────────────────────────────────[/dim]")
     right_grid.add_row(f"[bold green]🚀 Features in v{__version__}[/bold green]")
     right_grid.add_row("[dim]Universal AI: Claude 3.7 Sonnet, OpenAI GPT-4o, DeepSeek R1, Mistral, Gemini[/dim]")
     right_grid.add_row("[dim]Zero-Latency Direct SQL Fast-Path with autonomous AI auto-repair on error[/dim]")
-    right_grid.add_row("[dim]Multi-turn conversational session memory graph & persistent connection pooling[/dim]")
+    right_grid.add_row("[dim]Cross-platform instant clipboard copy (SQL, CSV, TSV Excel, JSON) & bracketed paste[/dim]")
 
     layout_table = Table.grid(expand=True, padding=(0, 2))
     layout_table.add_column(ratio=2)
@@ -81,7 +82,7 @@ def render_chat_header(
     )
 
     console.print(header_panel)
-    console.print(f"[bold cyan]│[/bold cyan] [bold cyan]⚡ Multi-AI Engine Live![/bold cyan] [dim]Type [bold white]:models[/bold white] to switch AI models · [bold white]:doctor[/bold white] for diagnostics · Mode: [bold yellow]{mode}[/bold yellow][/dim]\n")
+    console.print(f"[bold cyan]│[/bold cyan] [bold cyan]⚡ Multi-AI Engine Live![/bold cyan] [dim]Type [bold white]:models[/bold white] to switch AI models · [bold white]:copy[/bold white] to copy · Mode: [bold yellow]{mode}[/bold yellow][/dim]\n")
 
     if recommendations:
         console.print("[dim italic]💡 Try asking:[/dim italic]")
@@ -177,8 +178,12 @@ def render_assistant_turn(
                 )
                 console.print(bar_chart)
                 console.print("")
+
+            console.print("[dim]💡 Quick Copy: [bold white]:copy[/bold white] (SQL) · [bold white]:copy csv[/bold white] / [bold white]:copy tsv[/bold white] (Excel) / [bold white]:copy json[/bold white] · [bold white]:paste[/bold white] to run from clipboard[/dim]")
         else:
             print_info("Query executed successfully. No rows returned.")
+            if result.sql:
+                console.print("[dim]💡 Quick Copy: [bold white]:copy[/bold white] (SQL) · [bold white]:paste[/bold white] to run from clipboard[/dim]")
 
         if result.confidence:
             console.print(result.confidence.format_summary())
@@ -204,7 +209,7 @@ def render_assistant_turn(
     elif result.sql:
         syntax = Syntax(result.sql.strip(), "sql", theme="monokai", line_numbers=False)
         console.print(Panel(syntax, title="Generated SQL", border_style="dim"))
-        console.print("")
+        console.print("[dim]💡 Quick Copy: [bold white]:copy[/bold white] (SQL) · [bold white]:paste[/bold white] to run from clipboard[/dim]\n")
 
 
 def render_session_history(query_history: List[PipelineResult]) -> None:

dbagent_cli-0.11.5/dbagent/ui/clipboard.py

@@ -0,0 +1,280 @@
+"""
+Cross-Platform Clipboard & Multiline Paste Engine for DB-Agent.
+Provides zero-dependency, ultra-fast system clipboard access across Windows, macOS, and Linux,
+with formatting support for SQL, CSV, TSV, JSON, and Markdown tables.
+"""
+
+import os
+import sys
+import csv
+import json
+import io
+import subprocess
+from typing import List, Dict, Any, Optional, Tuple
+
+
+class ClipboardManager:
+    """
+    Zero-dependency, cross-platform clipboard manager.
+    Supports Windows (Win32 ctypes + PowerShell), macOS (pbcopy/pbpaste), and Linux (wl-copy, xclip, xsel).
+    """
+
+    @classmethod
+    def copy_text(cls, text: str) -> Tuple[bool, str]:
+        """
+        Copy text to the OS system clipboard.
+        Returns (success, message).
+        """
+        if not text:
+            return False, "Nothing to copy (empty text)."
+
+        # 1. Try pyperclip if installed
+        try:
+            import pyperclip
+            pyperclip.copy(text)
+            return True, f"Copied {len(text):,} characters to clipboard"
+        except ImportError:
+            pass
+
+        # 2. Windows: Native Win32 API via ctypes (zero-latency <0.1ms)
+        if sys.platform == "win32":
+            try:
+                import ctypes
+                from ctypes import wintypes
+
+                CF_UNICODETEXT = 13
+                GMEM_MOVEABLE = 0x0002
+
+                user32 = ctypes.windll.user32
+                kernel32 = ctypes.windll.kernel32
+
+                kernel32.GlobalAlloc.restype = ctypes.c_void_p
+                kernel32.GlobalAlloc.argtypes = [wintypes.UINT, ctypes.c_size_t]
+                kernel32.GlobalLock.restype = ctypes.c_void_p
+                kernel32.GlobalLock.argtypes = [ctypes.c_void_p]
+                kernel32.GlobalUnlock.restype = wintypes.BOOL
+                kernel32.GlobalUnlock.argtypes = [ctypes.c_void_p]
+
+                user32.OpenClipboard.restype = wintypes.BOOL
+                user32.OpenClipboard.argtypes = [wintypes.HWND]
+                user32.EmptyClipboard.restype = wintypes.BOOL
+                user32.CloseClipboard.restype = wintypes.BOOL
+                user32.SetClipboardData.restype = ctypes.c_void_p
+                user32.SetClipboardData.argtypes = [wintypes.UINT, ctypes.c_void_p]
+
+                if user32.OpenClipboard(None):
+                    try:
+                        user32.EmptyClipboard()
+                        encoded = text.encode("utf-16le") + b"\x00\x00"
+                        h_mem = kernel32.GlobalAlloc(GMEM_MOVEABLE, len(encoded))
+                        if h_mem:
+                            p_mem = kernel32.GlobalLock(h_mem)
+                            if p_mem:
+                                ctypes.memmove(p_mem, encoded, len(encoded))
+                                kernel32.GlobalUnlock(h_mem)
+                                user32.SetClipboardData(CF_UNICODETEXT, h_mem)
+                                return True, f"Copied {len(text):,} characters to clipboard"
+                    finally:
+                        user32.CloseClipboard()
+            except Exception:
+                pass
+
+            # Windows Fallback: PowerShell Set-Clipboard
+            try:
+                proc = subprocess.Popen(
+                    ["powershell", "-NoProfile", "-Command", "Set-Clipboard -Value $input"],
+                    stdin=subprocess.PIPE,
+                    stdout=subprocess.PIPE,
+                    stderr=subprocess.PIPE,
+                    text=True,
+                )
+                proc.communicate(input=text, timeout=3)
+                if proc.returncode == 0:
+                    return True, f"Copied {len(text):,} characters to clipboard"
+            except Exception:
+                pass
+
+        # 3. macOS: pbcopy
+        elif sys.platform == "darwin":
+            try:
+                proc = subprocess.Popen(
+                    ["pbcopy"],
+                    stdin=subprocess.PIPE,
+                    stdout=subprocess.PIPE,
+                    stderr=subprocess.PIPE,
+                )
+                proc.communicate(input=text.encode("utf-8"), timeout=3)
+                if proc.returncode == 0:
+                    return True, f"Copied {len(text):,} characters to clipboard"
+            except Exception:
+                pass
+
+        # 4. Linux: Wayland wl-copy or X11 xclip/xsel
+        else:
+            for cmd in [["wl-copy"], ["xclip", "-selection", "clipboard"], ["xsel", "--clipboard", "--input"]]:
+                try:
+                    proc = subprocess.Popen(
+                        cmd,
+                        stdin=subprocess.PIPE,
+                        stdout=subprocess.PIPE,
+                        stderr=subprocess.PIPE,
+                    )
+                    proc.communicate(input=text.encode("utf-8"), timeout=3)
+                    if proc.returncode == 0:
+                        return True, f"Copied {len(text):,} characters to clipboard"
+                except Exception:
+                    continue
+
+        return False, "Could not access system clipboard."
+
+    @classmethod
+    def get_text(cls) -> Tuple[Optional[str], str]:
+        """
+        Get text from the OS system clipboard.
+        Returns (text, message).
+        """
+        # 1. Try pyperclip if installed
+        try:
+            import pyperclip
+            val = pyperclip.paste()
+            if val:
+                return val, "Retrieved text from clipboard"
+        except ImportError:
+            pass
+
+        # 2. Windows: Native Win32 API via ctypes
+        if sys.platform == "win32":
+            try:
+                import ctypes
+                from ctypes import wintypes
+
+                CF_UNICODETEXT = 13
+                user32 = ctypes.windll.user32
+                kernel32 = ctypes.windll.kernel32
+
+                kernel32.GlobalLock.restype = ctypes.c_void_p
+                kernel32.GlobalLock.argtypes = [ctypes.c_void_p]
+                kernel32.GlobalUnlock.restype = wintypes.BOOL
+                kernel32.GlobalUnlock.argtypes = [ctypes.c_void_p]
+
+                user32.OpenClipboard.restype = wintypes.BOOL
+                user32.OpenClipboard.argtypes = [wintypes.HWND]
+                user32.CloseClipboard.restype = wintypes.BOOL
+                user32.GetClipboardData.restype = ctypes.c_void_p
+                user32.GetClipboardData.argtypes = [wintypes.UINT]
+
+                if user32.OpenClipboard(None):
+                    try:
+                        h_mem = user32.GetClipboardData(CF_UNICODETEXT)
+                        if h_mem:
+                            p_mem = kernel32.GlobalLock(h_mem)
+                            if p_mem:
+                                text = ctypes.c_wchar_p(p_mem).value
+                                kernel32.GlobalUnlock(h_mem)
+                                if text:
+                                    return text, f"Pasted {len(text):,} characters from clipboard"
+                    finally:
+                        user32.CloseClipboard()
+            except Exception:
+                pass
+
+            # Windows Fallback: PowerShell Get-Clipboard
+            try:
+                output = subprocess.check_output(
+                    ["powershell", "-NoProfile", "-Command", "Get-Clipboard"],
+                    text=True,
+                    timeout=3,
+                )
+                if output:
+                    return output.strip(), f"Pasted {len(output):,} characters from clipboard"
+            except Exception:
+                pass
+
+        # 3. macOS: pbpaste
+        elif sys.platform == "darwin":
+            try:
+                output = subprocess.check_output(["pbpaste"], text=True, timeout=3)
+                if output:
+                    return output.strip(), f"Pasted {len(output):,} characters from clipboard"
+            except Exception:
+                pass
+
+        # 4. Linux: Wayland wl-paste or X11 xclip/xsel
+        else:
+            for cmd in [["wl-paste"], ["xclip", "-selection", "clipboard", "-o"], ["xsel", "--clipboard", "--output"]]:
+                try:
+                    output = subprocess.check_output(cmd, text=True, timeout=3)
+                    if output:
+                        return output.strip(), f"Pasted {len(output):,} characters from clipboard"
+                except Exception:
+                    continue
+
+        return None, "Clipboard is empty or unavailable."
+
+    @classmethod
+    def format_results_as(
+        cls,
+        columns: List[str],
+        rows: List[Dict[str, Any]],
+        format_type: str = "csv",
+        table_name: str = "query_results",
+    ) -> str:
+        """
+        Formats query result set into CSV, TSV, JSON, Markdown, or SQL INSERT statements.
+        """
+        fmt = format_type.strip().lower()
+
+        # CSV format
+        if fmt == "csv":
+            out = io.StringIO()
+            writer = csv.DictWriter(out, fieldnames=columns)
+            writer.writeheader()
+            for r in rows:
+                writer.writerow(r)
+            return out.getvalue().strip()
+
+        # TSV format (Tab-separated, directly pasteable into Excel / Google Sheets)
+        if fmt in ("tsv", "excel", "sheets"):
+            out = io.StringIO()
+            writer = csv.DictWriter(out, fieldnames=columns, delimiter="\t")
+            writer.writeheader()
+            for r in rows:
+                writer.writerow(r)
+            return out.getvalue().strip()
+
+        # JSON format
+        if fmt in ("json", "js"):
+            return json.dumps(rows, indent=2, default=str)
+
+        # Markdown Table format
+        if fmt in ("md", "markdown"):
+            lines = []
+            lines.append("| " + " | ".join(columns) + " |")
+            lines.append("| " + " | ".join(["---"] * len(columns)) + " |")
+            for r in rows:
+                row_vals = [str(r.get(c, "")).replace("\n", " ").replace("|", "\\|") for c in columns]
+                lines.append("| " + " | ".join(row_vals) + " |")
+            return "\n".join(lines)
+
+        # SQL INSERT statements format
+        if fmt in ("sql", "insert", "inserts"):
+            stmts = []
+            cols_str = ", ".join(f"`{c}`" for c in columns)
+            for r in rows:
+                val_parts = []
+                for c in columns:
+                    v = r.get(c)
+                    if v is None:
+                        val_parts.append("NULL")
+                    elif isinstance(v, bool):
+                        val_parts.append("TRUE" if v else "FALSE")
+                    elif isinstance(v, (int, float)):
+                        val_parts.append(str(v))
+                    else:
+                        escaped = str(v).replace("'", "''")
+                        val_parts.append(f"'{escaped}'")
+                stmts.append(f"INSERT INTO {table_name} ({cols_str}) VALUES ({', '.join(val_parts)});")
+            return "\n".join(stmts)
+
+        # Default fallback to CSV
+        return cls.format_results_as(columns, rows, format_type="csv", table_name=table_name)

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/dbagent_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbagent-cli
-Version: 0.11.4
+Version: 0.11.5
 Summary: The Privacy-First AI Database Copilot, Schema Graph Introspector & Post-Commit Recovery Engine (CLI)
 Author: Santhosh Gupta
 License: MIT

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/dbagent_cli.egg-info/SOURCES.txt

@@ -60,6 +60,7 @@ dbagent/sql/__init__.py
 dbagent/sql/optimizer.py
 dbagent/sql/validator.py
 dbagent/ui/chat_screen.py
+dbagent/ui/clipboard.py
 dbagent/ui/console.py
 dbagent/ui/grid_window.py
 dbagent/ui/live_streamer.py
@@ -74,6 +75,7 @@ dbagent_cli.egg-info/top_level.txt
 tests/test_benchmarks.py
 tests/test_cache.py
 tests/test_cli.py
+tests/test_clipboard.py
 tests/test_connectors.py
 tests/test_demo_and_sample_db.py
 tests/test_direct_sql.py

{dbagent_cli-0.11.4 → dbagent_cli-0.11.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "dbagent-cli"
-version = "0.11.4"
+version = "0.11.5"
 description = "The Privacy-First AI Database Copilot, Schema Graph Introspector & Post-Commit Recovery Engine (CLI)"
 readme = "README.md"
 requires-python = ">=3.9"

dbagent_cli-0.11.5/tests/test_clipboard.py

@@ -0,0 +1,120 @@
+"""
+Unit tests for ClipboardManager cross-platform copy and paste engine.
+Verifies formatters (CSV, TSV, JSON, Markdown, SQL INSERT) and clipboard operations.
+"""
+
+import json
+import pytest
+from dbagent.ui.clipboard import ClipboardManager
+
+
+@pytest.fixture
+def sample_data():
+    columns = ["id", "username", "email", "active", "balance", "notes"]
+    rows = [
+        {
+            "id": 1,
+            "username": "santhosh",
+            "email": "santhosh@example.com",
+            "active": True,
+            "balance": 150.50,
+            "notes": "Admin user",
+        },
+        {
+            "id": 2,
+            "username": "alice",
+            "email": "alice@example.com",
+            "active": False,
+            "balance": 0.0,
+            "notes": "Test account",
+        },
+        {
+            "id": 3,
+            "username": "bob",
+            "email": "bob@example.com",
+            "active": True,
+            "balance": None,
+            "notes": None,
+        },
+    ]
+    return columns, rows
+
+
+def test_format_results_csv(sample_data):
+    columns, rows = sample_data
+    csv_out = ClipboardManager.format_results_as(columns, rows, format_type="csv")
+    lines = csv_out.splitlines()
+
+    assert len(lines) == 4
+    assert lines[0] == "id,username,email,active,balance,notes"
+    assert "santhosh@example.com" in lines[1]
+    assert "alice@example.com" in lines[2]
+    assert "bob@example.com" in lines[3]
+
+
+def test_format_results_tsv(sample_data):
+    columns, rows = sample_data
+    tsv_out = ClipboardManager.format_results_as(columns, rows, format_type="tsv")
+    lines = tsv_out.splitlines()
+
+    assert len(lines) == 4
+    assert lines[0] == "id\tusername\temail\tactive\tbalance\tnotes"
+    assert "santhosh\tsanthosh@example.com" in lines[1]
+
+
+def test_format_results_excel_alias(sample_data):
+    columns, rows = sample_data
+    excel_out = ClipboardManager.format_results_as(columns, rows, format_type="excel")
+    sheets_out = ClipboardManager.format_results_as(columns, rows, format_type="sheets")
+
+    assert "\t" in excel_out
+    assert excel_out == sheets_out
+
+
+def test_format_results_json(sample_data):
+    columns, rows = sample_data
+    json_out = ClipboardManager.format_results_as(columns, rows, format_type="json")
+    parsed = json.loads(json_out)
+
+    assert len(parsed) == 3
+    assert parsed[0]['username'] == "santhosh"
+    assert parsed[0]['active'] is True
+    assert parsed[1]['username'] == "alice"
+    assert parsed[2]['balance'] is None
+
+
+def test_format_results_markdown(sample_data):
+    columns, rows = sample_data
+    md_out = ClipboardManager.format_results_as(columns, rows, format_type="md")
+    lines = md_out.splitlines()
+
+    assert len(lines) == 5
+    assert "id" in lines[0] and "username" in lines[0]
+    assert "santhosh" in lines[2]
+
+
+def test_format_results_sql_insert(sample_data):
+    columns, rows = sample_data
+    sql_out = ClipboardManager.format_results_as(columns, rows, format_type="sql", table_name="users")
+    stmts = sql_out.splitlines()
+
+    assert len(stmts) == 3
+    assert "INSERT INTO users" in stmts[0]
+    assert "TRUE" in stmts[0]
+    assert "FALSE" in stmts[1]
+    assert "NULL" in stmts[2]
+
+
+def test_copy_text_empty():
+    success, msg = ClipboardManager.copy_text("")
+    assert not success
+    assert "Nothing to copy" in msg
+
+
+def test_clipboard_roundtrip_if_supported():
+    test_str = "DB-Agent Clipboard Test String 2026"
+    success, msg = ClipboardManager.copy_text(test_str)
+    if success:
+        retrieved, get_msg = ClipboardManager.get_text()
+        if retrieved is not None:
+            assert test_str in retrieved