# Toolserver repo toolset v2

Deze patch voegt een duidelijkere repo-toolset toe, met een macro-tool die het "pas repo aan en push naar test-branch" proces in 1 toolcall doet.

## Nieuwe (aanbevolen) tools

- `repo_open(repo_url, branch="main") -> {workspace_id,...}`
- `repo_search(query, mode="auto|grep|rag", workspace_id? / repo_url?, n_results=20, ...)`
- `repo_read(path, workspace_id? / repo_url?, start_line?, end_line?)`
- `repo_apply(workspace_id? / repo_url?, patch_b64|patch|files, dry_run=false)`
- `repo_push(workspace_id? / repo_url?, base_branch="main", new_branch?, branch_prefix="test", commit_message=...)`
- `repo_pr_create(repo_url, head_branch, base_branch="main", title, body?)`
- `repo_change_to_branch(repo_url, base_branch="main", patch_b64|patch|files, new_branch?/branch_prefix, commit_message, create_pr?, pr_title?, pr_body?)`

## Deprecated (blijft werken)

- `repo_grep` -> alias naar `repo_search(mode="grep")`
- `rag_index_repo` -> meestal niet meer nodig; `repo_search` indexeert automatisch
- `rag_query` -> gebruik `repo_search(mode="rag")`

## Belangrijke env vars

- `LLM_PROXY_URL=http://192.168.100.1:8081/v1/completions`  (of `/v1/chat/completions` als je proxy dat biedt)
- `GITEA_TOKEN=...` (alleen nodig voor PR create, en optioneel voor push auth als je repo_url geen creds bevat)
- `GITEA_USER=oauth2` (optioneel; default is oauth2 bij token-auth)
- `ALLOWED_GIT_HOSTS=10.25.138.40,192.168.100.1` (aanrader; leeg = alles toegestaan)

## Aanbevolen flow voor LLM

1) `repo_search(mode="auto")` om relevante bestanden te vinden  
2) `repo_read` om de files te lezen  
3) (LLM maakt patch)  
4) `repo_change_to_branch` met `patch_b64` om te pushen naar een test-branch (+ evt PR)