[!ABSTRACT] Epigraf
"Narzędzia LM Studio do zarządzania bazami danych — tworzenie, listowanie, usuwanie i metadane. Most między modelem LLM a Index Managerem."
§1. 📋 Metadata
Pole
Wartość
Nazwa
Database Tools
Moduł
src/tools/database.tool.ts
Wersja
1.0.0
Status
Draft
Zależny od
Index Manager
Używany przez
LM Studio (model LLM wywołuje narzędzia)
§2. 🎯 Cel i Odpowiedzialność
§2.1 Cel
Udostępnienie modelowi LLM zestawu narzędzi do zarządzania bazami danych (katalogami z tabelami CSV). Każde narzędzie to funkcja zarejestrowana w LM Studio SDK.
§2.2 Odpowiedzialności
Definiowanie narzędzi zgodnych ze standardem LM Studio Tools
Walidacja parametrów wejściowych przed przekazaniem do engine
Mapowanie wyników engine na odpowiedź zrozumiałą dla LLM
Obsługa błędów z czytelnymi komunikatami dla modelu
§3. 🛠️ Specyfikacja API/Funkcji
§3.1 Tool: create_database
Pole
Wartość
Nazwa
create_database
Opis
Tworzy nową bazę danych (katalog z indeksem)
Wywołuje
IndexManager.initDatabase(name)
Parametry:
Parametr
Typ
Wymagany
Opis
name
string
✅
Nazwa bazy (identyfikator — [a-zA-Z0-9_-]+)
displayName
string
❌
Wyświetlana nazwa (opcjonalnie)
description
string
❌
Opis bazy
Zwraca:
Pole
Typ
Opis
success
boolean
Czy operacja się powiodła
name
string
Nazwa utworzonej bazy
path
string
Ścieżka do katalogu bazy
Błędy:DUPLICATE_DATABASE, FILESYSTEM_ERROR
§3.2 Tool: list_databases
Pole
Wartość
Nazwa
list_databases
Opis
Listuje wszystkie istniejące bazy danych
Wywołuje
IndexManager.getDatabases()
Parametry: Brak
Zwraca:
Pole
Typ
Opis
databases
DatabaseInfo[]
Lista baz z metadanymi
total
number
Łączna liczba baz
§3.3 Tool: delete_database
Pole
Wartość
Nazwa
delete_database
Opis
Usuwa bazę danych wraz ze wszystkimi tabelami
Wywołuje
IndexManager.deleteDatabase(name)
Parametry:
Parametr
Typ
Wymagany
Opis
name
string
✅
Nazwa bazy do usunięcia
confirm
boolean
✅
Potwierdzenie usunięcia (== true)
Zwraca:
Pole
Typ
Opis
success
boolean
Czy operacja się powiodła
deletedTables
number
Liczba usuniętych tabel
Błędy:DB_NOT_FOUND
§3.4 Tool: get_database_info
Pole
Wartość
Nazwa
get_database_info
Opis
Zwraca metadane bazy: liczba tabel, rozmiar, data utworzenia