Araçlar ve izinler — Vulgr Dokümantasyon

Araçlar

Araç	Ne yapar
`read`	Bir dosyayı okur.
`glob`	Dosyaları desene göre bulur (ignore kurallarına uyar).
`grep`	Dosya içeriklerinde arar.
`edit`	Mevcut bir dosyada hedefli değişiklik yapar.
`write`	Bir dosya oluşturur ya da üzerine yazar.
`exec_command`	Ajanın kendi PTY oturumlarından birinde komut çalıştırır.
`write_stdin`	Çalışan bir oturuma girdi gönderir ve yeni çıktısını okur.
`read_block`	Bir komut bloğunun çıktısını okur.
`update_plan`	Ajanın adım adım planını güncel tutar.
`ask_user`	Size bir soru sorar ve cevabı bekler.

Ajanın kendi shell’leri

Ajan komutları asla sizin shell’inizde çalışmaz ve prompt’unuza yazılmaz. Her exec_command, ajana ait ayrı bir PTY oturumunda çalışır ve sandbox’lanabilir. Uzun süren bir komut session_id döner; ajan beklemek yerine onu write_stdin ile izler.

Hatalar

Başarısız bir araç turu çökertmez. Hata modele is_error sonucu olarak döner; model okur ve başka bir yol dener.

İzinler

permissions/ iki parçadan oluşur: komut sınıflandırma ve politika.

Sınıflandırma

Her komut şu sınıflardan birine girer:

Sınıf	Anlamı
`readonly`	Yalnızca okur (örneğin `ls`, `cat`, `git status`).
`shell-state`	Shell’in durumunu değiştirir (örneğin `cd`, `export`).
`dangerous`	Veriyi yok edebilir ya da sistemi değiştirebilir.
`unknown`	Tanınmayan.

Sınıflandırma fail-closed’dur: tanınmayan her şey unknown sayılır ve temkinle ele alınır; asla güvenli varsayılmaz.

Modlar

Mod	Davranış
`ask`	Güvenli olmayan her şeyden önce sorar.
`acceptEdits`	Dosya düzenlemeleri otomatik kabul edilir; diğer eylemler yine sorar.
`plan`	Ajan plan yapar ama hiçbir şeyi değiştirmez.
`yolo`	Her şeye izin verilir.

Kural önceliği

deny > ask > allow. Deny kuralı her zaman kazanır, sonra ask, sonra allow. Korumalı yollar, mod ne olursa olsun korunur.