Skip to content

Data tools ​

calculator, the SQLite tools, and the local embedding store are always on. The SQLite tools use db_path. If db_path is not set, they use KDEPS_SQL_DB_PATH. Wolfram, remote RAG, and the rerankers register only when you set their key or URL. They are declared HTTP tools, and their tool asset fully defines them. Before sql_query text runs, kdeps removes its HTML escapes, as for bash_exec.

Permission modes stay on Built-in tools.

Computation ​

ToolRequired env varDescription
calculator(none)Evaluate an arithmetic expression: numbers, + - * / // % **, parentheses and the math module's functions and constants (sqrt(16), log(8, 2), pi). A python: block in tools/calculator.yaml; exponents above 10000 are rejected
wolfram_alphaWOLFRAM_APP_IDWolfram Alpha queries

Data and SQL ​

The three SQLite tools are python: blocks in their tool assets (Python's built-in sqlite3). Each tool opens the file read-only (mode=ro), so a query cannot write to it. First, the tool compares db_path with KDEPS_WORKSPACE_ROOT. Paths under ~/.kdeps and /tmp are also permitted. sql_ops (named connections, any driver) stays in Go.

ToolRequired env varDescription
sql_list_tablesdb_path or KDEPS_SQL_DB_PATHList the tables in a SQLite file
sql_describe_tablesameThe table's CREATE TABLE statement
sql_querysameRun one SELECT or WITH query; tab-separated rows, column names first

Embeddings and reranking ​

ToolRequired env varDescription
embedding_vectorize(none)Convert text to embeddings and index it in the local embedding DB
embedding_search(none)Semantic search over the local embedding DB
retrieve_contextKDEPS_RAG_BASE_URLRetrieve chunks from a remote RAG endpoint (only registered when the URL is set)
cohere_rerankCOHERE_API_KEYRerank results using Cohere
voyageai_rerankVOYAGEAI_API_KEYRerank results using VoyageAI
jina_rerankJINA_API_KEYRerank results using Jina

kdeps has the Apache 2.0 License.