34 lines
1.7 KiB
Markdown
34 lines
1.7 KiB
Markdown
|
# 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)
|