toolserver/README.md
2026-02-23 15:59:34 +01:00

1.7 KiB

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)