@kahinmcp/kahin 0.3.6 → 0.3.8

package/CHANGELOG.md

@@ -1,5 +1,137 @@
 # Changelog
 
+## Unreleased
+
+## [0.3.8] — 2026-08-08
+
+### Eklenen
+- `kahin_mirage_expect` / `kahin_mirage_check` / `kahin_mirage_uncheck` /
+  `kahin_mirage_select_option` / `kahin_mirage_dblclick` / `kahin_mirage_drag` /
+  `kahin_mirage_wait_for_text` / `kahin_mirage_wait_for_timeout` /
+  `kahin_mirage_route` eklendi: retry'li web-first assertion, doğrulamalı
+  checkbox/radio/select eylemleri, gerçek çift tıklama, sınırlı drag-and-drop,
+  metin/süre bekleme ve tek sonraki istek için abort/continue/fulfill route.
+- `kahin_mirage_wait_selector` artık `state=attached|visible|enabled`
+  (varsayılan `visible`) destekler; timeout yanıtı `code:"timeout"` ve son
+  `reason` ile döner.
+- `kahin_mirage_query` / `kahin_mirage_query_all` / `kahin_mirage_type` /
+  `kahin_mirage_wait_selector` locator motorunu kabul eder (`css=` / `text=` /
+  `role=` / `xpath=` / `nth=` ve `>>` zincirleme).
+- `kahin_mirage_click` / `kahin_mirage_hover` / `kahin_mirage_focus` aksiyon
+  öncesi Playwright tarzı actionability bekler (görünür, enabled, stabil,
+  engelsiz; retry + `timeout` parametresi).
+- `kahin_navigate` artık `wait_until=commit|domcontentloaded|load|networkidle`,
+  bounded `timeout` ve `referer` kabul eder; lifecycle beklemesi aşılırsa
+  `code:"navigation_timeout"` döner.
+- Faz 2 agent-native yüzey: `kahin_mirage_snapshot` (ref'li, token bütçeli
+  satırlar; truncation asla sessiz değildir), `kahin_mirage_fill_form`
+  (ref'lerle çok alanlı doldurma; stale ref `requiresSnapshot` döner) ve
+  click/type/check/uncheck/select_option/dblclick/drag'e opsiyonel
+  `return_snapshot` kancası.
+- Oturum kalıcılığı: `kahin_mirage_state_save` / `kahin_mirage_state_load`
+  (url + cookie + local/sessionStorage; mutlak yol zorunlu, load önce
+  kaydedilen url'e döner).
+- Kimlik kalıcılığı: `kahin_identity_new` / `kahin_identity_save` /
+  `kahin_identity_list` / `kahin_identity_delete` / `kahin_identity_report` +
+  `kahin_browser_start(identity=...)` ile gerçek Camoufox fingerprint
+  pinleme; rapor canlı `navigator.userAgent`'ı sayfa-içi doğrular.
+- `kahin_agent_status`: agent döngüsü özeti — engine liveness, sayfa durumu,
+  sekme sayısı, gerçek DOM-stream bookkeeping'inden `refsLive`/`domCursor`,
+  dialog/network/console sayaçları ve identity; engine yoksa yapılandırılmış
+  idle yanıt, asla hata fırlatmaz.
+- Faz 3 stealth/anti-detect yüzeyi: `kahin_stealth_audit` (14 salt-okunur
+  leak probe'u, skor `{passed, total, ratio}`; hiçbir check atlanmaz),
+  `kahin_mirage_mouse_trajectory` / `kahin_mirage_click_humanized` ve
+  cadence'li `kahin_mirage_key_text` (jitter'lı Bézier yörünge, gerçek DOM
+  tıklaması, jitter'lı tuş hızı; hepsi seed'li deterministik).
+- Domain başına kimlik rotasyonu: `kahin_identity_pin` / `kahin_identity_unpin`
+  / `kahin_identity_pins` / `kahin_identity_for_domain` — kanonik domain
+  anahtarlı, bounded ve doğrulanmış `~/.config/kahin/pins.json` deposu.
+- `kahin_fingerprint_report` (canlı sayfadan sitenin göreceği fingerprint;
+  emülasyon onayından kanıt üretmez) ve `kahin_proxy_resolve` + `kahin_browser_start(proxy=...)`
+  (proxy exit-IP geo + timezone/locale/geolocation önerileri; URL kimlik
+  bilgileri asla loglanmaz; aktif engine config'iyle çakışma
+  `engine_config_conflict`).
+- Stealth CI kapısı: `KAHIN_REQUIRE_STEALTH=1` altında audit ratio ≥ 0.8 ve
+  identity rotasyonu tam fingerprint özetini değiştirmek zorunludur;
+  `scripts/stealth-regression.py` drift-watcher'ı sabitlenmiş
+  `camoufox-harness/tests/perf/stealth-baseline.json` ile karşılaştırır
+  (0 = temiz, 1 = yeni leak, 2 = ortam; baseline yalnızca
+  `KAHIN_UPDATE_BASELINE=1` ile yeniden yazılır) ve GitLab `stealth-regression`
+  job'ı (`stage: verify`, real-e2e ile aynı unprivileged/GTK kurulumu)
+  schedule/main'da suite + regression'ı çalıştırır.
+- Faz 4 performans yüzeyi: Zig sidecar non-blocking'e geçti — tek-in-flight
+  darboğazı kalktı, stdin işleme browser yanıtını asla bloklamaz ve birden
+  fazla istek aynı anda in-flight olabilir (IPC sözleşmesi değişmedi). N=20
+  `Runtime.evaluate` concurrency probe'u
+  (`camoufox-harness/tests/perf/concurrency.md`): seri 74.78 → 28.56 ms,
+  paralel duvar süresi 56.89 → 8.71 ms (6.5× düşüş), ratio 1.314 → 3.281.
+- `kahin_engine_stats` eklendi: monotonic clock ile uptime + healer
+  tracker'dan bounded per-tool rollup (`tool_calls`/`tool_errors`,
+  `top_slow` ≤ 10, `last_error`); tüm `safe()` süre ölçümleri
+  `time.monotonic()`'a taşındı; engine yoksa yapılandırılmış
+  `engine_unavailable` yanıtı döner.
+- Identity başına bounded profile prewarm: stabil sha256 identity hash +
+  ölçülen hazırlık süreleri in-process cache (max 8, FIFO) ve
+  `~/.cache/kahin/profiles/<hash>.json` içinde tutulur; gerçek launch işi
+  asla atlanmaz (dürüst metadata/reuse kaydı; kimlik payload'ı metadata'da
+  saklanmaz).
+
+### Düzeltilen
+- Obscura/Shadow doğrudan screenshot çağrısını artık fail-closed reddeder;
+  görsel capture sözleşmesi Mirage’a ait kalır ve generic CDP yolu Mirage’a
+  doğru şekilde yükseltilir.
+- Stealth CI gate’i Xvfb ile sabit bir grafik yüzeyinde ve `TZ=Etc/UTC` ile
+  çalışır; timezone probe’u geçerli `UTC` çıktısını da kabul eder. Böylece
+  runner’ın DISPLAY/TZ farkları gerçek stealth drift’i gibi raporlanmaz.
+- Release tag’leri stealth regression kapısından geçmeden npm publish’e
+  ulaşamaz; npm publish sonrası registry’den sürüm tekrar okunarak local
+  package sürümüyle birebir eşleşme kanıtlanır.
+- Identity rotation e2e gate’i Linux/Windows kimlik çiftiyle en az iki canlı
+  fingerprint boyutunu deterministik doğrular; yalnızca runner WebGL’ine
+  bağlı rastgele identity çakışması artık release’i düşürmez.
+- CI browser image’larına Mesa/llvmpipe runtime’ı eklenerek WebGL stealth
+  probe’u gerçek software-rendered context üzerinde doğrulanır; baseline
+  gevşetilmez.
+- Runner’da Mesa’nın gerçek software renderer’ı açıkça `llvmpipe` olarak
+  seçilir; WebGL gate’i yalnızca kütüphanelerin kurulu olmasına güvenmez.
+- Stealth audit’in webgl check’i artık runner grafik yığınından bağımsız:
+  WebGL API varlığını (context entry point) doğrular; GL’siz CI runner’ında
+  context oluşturma başarısızlığı artık sahte “leak” olarak raporlanmaz.
+  CI browser gate’leri ayrıca Mesa GL kütüphanelerini kurar, böylece GL
+  sunan runner’larda `fingerprint_report` gerçek WebGL değerlerini okur.
+- `lib/` içindeki gömülü wheel HEAD kaynağından yeniden üretildi: Obscura
+  screenshot guard’ı, stealth/agent/reliability modülleri ve güncel Zig
+  sidecar dahil — npm paketinin taşıdığı wheel ile kaynak ağacı senkron
+  kalır.
+
+## [0.3.7] — 2026-08-06
+
+### Eklenen
+- Gerçek Camoufox/Mirage akışı için canlı DOM snapshot/event cursor sözleşmesi;
+  stale node, reset ve dropped durumları artık ajanı yeni snapshot almaya zorlar.
+- CI üzerinde Playwright veya sahte e2e yerine checkout'tan derlenen Zig sidecar,
+  resmi Camoufox ve zorunlu gerçek browser testlerinden oluşan release gate'i.
+
+### Düzeltilen
+- Mirage çağrıları, DOM/input/network/storage/screencast ve iframe işlemlerinde
+  doğru page/session sahipliğine sabitlendi; paralel sekmeler birbirine karışmaz.
+- Sidecar IPC ve process lifecycle hataları artık yutulmadan fail-closed davranır;
+  screenshot, upload, accessibility ve network yanıtları bounded hale getirildi.
+- npm launcher her kurulumda gömülü wheel'i günceller ve Camoufox binary'sini
+  hazırlar; npm release sorgusu ağ/auth hatalarını yanlışlıkla başarı saymaz.
+- GitLab gerçek-browser job'u Firefox'u Docker root olarak çalıştırmaz; npm
+  publish artık release-check yanında real-e2e kapısına da bağlıdır.
+- CI image'ına Camoufox'un GTK/DBus/audio/X11 runtime bağımlılıkları eklendi;
+  testten önce gerçek binary `--version` ile başlatılabilirliği doğrulanıyor.
+- Network response-body çağrıları, request event'i gövde erişilebilir olmadan
+  geldğinde native completion yarışını sınırlı retry ile güvenle tamamlıyor.
+
+### Testler
+- Gerçek Camoufox/Mirage uygulama suite'i: 120 passed.
+- Zig sidecar testleri: 201/201 passed; ruff, compile, shell/YAML ve npm pack
+  release kontrolleri başarılı.
+
 ## [0.3.6] — 2026-08-06
 
 ### Düzeltilen
@@ -171,3 +303,5 @@ Tüm önemli değişiklikler bu dosyada tutulur. Format: [Keep a Changelog](http
 [0.1.8]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.7...v0.1.8
 [0.1.7]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.6...v0.1.7
 [0.3.6]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.3.5...v0.3.6
+[0.3.7]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.3.6...v0.3.7
+[0.3.8]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.3.7...v0.3.8

package/README.md

@@ -16,7 +16,7 @@ AI modeller Chrome'un içine girip sayfa gezip kod çalıştırabilir ama CDP'yi
 
 56 domain, 667 komut, 237 event, 609 type — Chrome 148 protokolü gömülü.
 
-## 109 Tool · 4 Kategori Ailesi · 2 Engine
+## 139 Tool · 4 Kategori Ailesi · 2 Engine
 
 Tool'lar engine-ayrımlı kategori dosyalarında (`kahin/tools/`): paylaşılan çekirdek + Obscura + Camoufox aileleri.
 
@@ -29,10 +29,10 @@ Tool'lar engine-ayrımlı kategori dosyalarında (`kahin/tools/`): paylaşılan
 |  DEJA_VU — Debug | CDP event geçmişi, network istekleri, console mesajları | 4 |
 |  PROPHECY — Pattern DB | Kullanım desenlerini öğren, sorgula, öner | 5 |
 |  HEALER | Hata istatistikleri | 1 |
-|  MIRAGE — Camoufox Native (77) | Juggler protokolü üstünde gerçek-zamanlı DOM stream, DOM, Input, PageEx, Tab, Network, Storage, Emulation, Dialog/Download/Worker/WS, Upload, Screencast, Accessibility, Engine sağlığı | 77 |
+|  MIRAGE — Camoufox Native (107) | Juggler protokolü üstünde gerçek-zamanlı DOM stream, DOM, Reliability, Input, PageEx, Tab, Network, Storage, Emulation, Dialog/Download/Worker/WS, Upload, Screencast, Accessibility, Engine sağlığı/istatistik, Agent-native snapshot/form/state/identity/status, Stealth audit/insansı girdi/identity rotasyonu/proxy-geo | 107 |
 |  OBSCURA — Ayrı kategori | Obscura'ya özel tool'lar (hazırlanıyor) | 0 |
 
-**Toplam: 109 tool.**
+**Toplam: 139 tool.**
 
 ## Bir satırda özet
 
@@ -40,7 +40,9 @@ CDP'yi bilmeyen AI'a Chrome'u kontrol etmeyi öğreten, yanlış yapınca düzel
 
 ## Kurulum
 
-Zorunlu: Python 3.12+ · Chrome/Chromium · Node.js 18+ (npm launcher için)
+Zorunlu: Python 3.12+ · Node.js 18+ (npm launcher için). Kahin'in varsayılan
+Camoufox binary'si kurulum sırasında resmi `camoufox fetch` komutuyla hazır edilir;
+Chrome/Chromium kurulumu gerekmez.
 
 ### Otomatik kurulum — tek komut
 
@@ -104,9 +106,12 @@ Camoufox (Juggler native) ile:
 → kahin_mirage_set_user_agent / set_viewport / set_geolocation
 → kahin_mirage_set_file_chooser_intercept(true) → kahin_mirage_upload_files(["/abs/path"])
 → kahin_mirage_screencast_start → kahin_mirage_screencast_frame (base64 JPEG)
-→ kahin_mirage_accessibility_tree → kahin_engine_health
+→ kahin_mirage_accessibility_tree → kahin_engine_health → kahin_engine_stats
 → kahin_mirage_dom_start → kahin_mirage_dom_snapshot → kahin_mirage_dom_events
 → kahin_mirage_dom_action (snapshot'tan alınan canlı nodeId ile)
+→ kahin_mirage_snapshot (ref'li ajan görünümü) → kahin_mirage_fill_form
+→ kahin_mirage_state_save/load → kahin_identity_new/save/list/delete/report
+→ kahin_agent_status (agent döngüsü özeti)
 ```
 
 `kahin_browser_start` tek bir Camoufox/sidecar süreci açar. İlk sayfa işlemi
@@ -156,15 +161,15 @@ Kahin'de hata loglama ve kendini onarma sistemi gömülüdür:
 
 ```
 oracle.py               → MCP server (bootstrap: mcp instance + engine lifecycle + main)
-  tools/                → 109 tool, engine-ayrımlı kategori dosyaları
+  tools/                → 139 tool, engine-ayrımlı kategori dosyaları
     _common.py          → capability routing, _safe_cdp, _require_engine, _auto_learn
     the_twins/capabilities → motor-yetenek sözleşmesi ve Mirage yükseltme matrisi
     grimoire/seraph/prophecy/healer → CDP bilgi + doğrulama + pattern (paylaşılan)
     pilot/trainman/dejavu           → browser/session/debug (paylaşılan)
     pilot_mirage/trainman_mirage/dejavu_mirage → Camoufox DOM+Input+PageEx / Tab / Network+Console
     storage_mirage/emulation_mirage/dialog_mirage → Storage / Emulation / Dialog+Download+Worker+WS
-    pilot_obscura/trainman_obscura/dejavu_obscura → Obscura ayrı kategoriler (hazırlanıyor)
-    engine.py           → engine_health
+    pilot_obscura/trainman_obscura/dejavu_obscura → Shadow için ayrılmış paket sınırları; sahte tool kaydetmez
+    engine.py           → engine_health + engine_stats
   _healer.py            → Hata yönetimi, loglama, kendini onarma
   the_source/architect  → CDP şema motoru (56 domain, 667 komut)
   the_twins/shadow      → Obscura engine (gerçek Obscura binary, WebSocket CDP)
@@ -185,7 +190,8 @@ camoufox-harness/       → Zig sidecar (Juggler protocol, vendor binary gömül
 - [x] **Tek tık kurulum** — `pnpm add -g @kahinmcp/kahin`, sonra `kahin` (ilk çalıştırmada Python ortamını otomatik kurar)
 - [ ] **Zero-dependency** hedefi (Go/Rust portu)
 - [ ] **LSP modu** — kod içinde hata yakalama, AI'a yanlışını yüzüne vurma
-- [x] **Tool sayısı 109** — Camoufox Juggler-native 77 tool (gerçek-zamanlı DOM stream, DOM, Input, Network, Storage, Emulation, Dialog, Tab, Worker/WS, Upload, Screencast, Accessibility) + paylaşılan 32 çekirdek
+- [x] **Tool sayısı 139** — Camoufox Juggler-native 107 tool (gerçek-zamanlı DOM stream, DOM, Reliability, Input, Network, Storage, Emulation, Dialog, Tab, Worker/WS, Upload, Screencast, Accessibility, Engine sağlığı/istatistik, Agent-native snapshot/form/state/identity/status, Stealth audit/humanized input/identity pins/proxy geo) + paylaşılan 32 çekirdek
+- [x] **Faz 4 performans yüzeyi** — non-blocking Zig sidecar (N=20 probe: paralel duvar 56.89 → 8.71 ms, ratio 1.314 → 3.281), `kahin_engine_stats` (monotonic uptime + per-tool rollup, top_slow ≤ 10) ve identity başına bounded prewarm metadata (launch asla atlanmaz; dürüst reuse kaydı)
 - [ ] **Obscura ayrı tool'ları** — CDP-yeteneklerine özel pilot_obscura/trainman_obscura/dejavu_obscura kategorilerini doldur
 
 - [ ] **Gerçek zamanlı izleme** — AI'ın Kahin'i nasıl kullandığını canlı gör
@@ -207,7 +213,7 @@ camoufox-harness/       → Zig sidecar (Juggler protocol, vendor binary gömül
 ## Geliştirme
 
 ```bash
-uv run pytest tests/          # 109 tests (all pass when Camoufox is available)
+uv run pytest -q tests/       # gerçek motor mevcutsa E2E dahil tam suite
 uv run ruff check kahin/      # lint
 uv run python -m kahin.oracle # manuel başlatma
 ```

package/bin/kahin.mjs

@@ -14,6 +14,10 @@ const PY = process.platform === "win32" ? join(VENV, "Scripts", "python.exe") :
 function sh(cmd, args, opts = {}) {
   return new Promise((resolve) => {
     const c = spawn(cmd, args, { stdio: ["ignore", "ignore", "pipe"], ...opts });
+    c.on("error", (err) => {
+      process.stderr.write(`[kahin] ${cmd} başlatılamadı: ${err.message}\n`);
+      resolve(1);
+    });
     c.stderr.on("data", (d) => process.stderr.write(`[kahin] ${d}`));
     c.on("close", (code) => resolve(code));
   });
@@ -41,6 +45,12 @@ const args = process.argv.slice(2);
 if (args[0] === "setup") {
   const { setup: registerClients } = await import("./setup.mjs");
   registerClients();
+  const { installPython } = await import("./setup.mjs");
+  const install = await installPython();
+  if (install && install.error) {
+    process.stderr.write(`[kahin] Python/Camoufox kurulumu başarısız (çıkış ${install.error})\n`);
+    process.exit(1);
+  }
   process.exit(0);
 }
 

package/bin/setup.mjs

@@ -324,10 +324,12 @@ export function setup() {
 const KAHIN_HOME = process.env.KAHIN_HOME || join(homedir(), ".local", "share", "kahin");
 const KAHIN_VENV = join(KAHIN_HOME, "venv");
 const KAHIN_PY = process.platform === "win32" ? join(KAHIN_VENV, "Scripts", "python.exe") : join(KAHIN_VENV, "bin", "python");
-const KAHIN_WHEEL = join(dirname(fileURLToPath(import.meta.url)), "..", "lib", "kahin-0.3.6-py3-none-any.whl");
+const KAHIN_WHEEL = join(dirname(fileURLToPath(import.meta.url)), "..", "lib", "kahin-0.3.8-py3-none-any.whl");
 
-// Gömülü wheel'i venv'e kurar. Postinstall'da ve `kahin setup`'ta çalışır.
-// PyPI'a bağımlı DEĞİL — wheel paketle birlikte gelir.
+// Gömülü wheel'i venv'e kurar ve varsayılan Camoufox binary'sini hazırlar.
+// PyPI'a bağımlı DEĞİL — wheel paketle birlikte gelir; wheel'in bağımlılıkları
+// (Camoufox dahil) pip tarafından kurulup resmi `camoufox fetch` ile tarayıcı
+// cache'i doldurulur.
 export async function installPython() {
   if (process.env.KAHIN_SKIP_PYTHON) {
     log("python kurulumu atlandı (KAHIN_SKIP_PYTHON)");
@@ -347,24 +349,35 @@ export async function installPython() {
       return { error: code };
     }
   }
-  const check = await run(KAHIN_PY, ["-c", "import kahin; print(kahin.__version__)"]);
-  if (check === 0) {
-    log("kahin zaten kurulu, atlandı");
-    return { installed: true };
-  }
   log(`wheel kuruluyor: ${KAHIN_WHEEL}`);
   const code = await run(KAHIN_PY, ["-m", "pip", "install", "--upgrade", KAHIN_WHEEL]);
   if (code !== 0) {
     log(`wheel kurulamadı (çıkış ${code})`);
     return { error: code };
   }
-  log("kahin python paketi kuruldu");
-  return { installed: true };
+  log("kahin python paketi kuruldu/güncellendi");
+
+  if (process.env.KAHIN_SKIP_CAMOUFOX_FETCH) {
+    log("Camoufox fetch atlandı (KAHIN_SKIP_CAMOUFOX_FETCH)");
+    return { installed: true, camoufox: "skipped" };
+  }
+  log("Camoufox browser hazırlanıyor (resmi camoufox fetch)...");
+  const browserCode = await run(KAHIN_PY, ["-m", "camoufox", "fetch"]);
+  if (browserCode !== 0) {
+    log(`Camoufox browser hazırlanamadı (çıkış ${browserCode}); kahin browser_start sırasında tekrar deneyecek`);
+    return { installed: true, camoufox: "error", error: browserCode };
+  }
+  log("Camoufox browser hazır");
+  return { installed: true, camoufox: "ready" };
 }
 
 function run(cmd, args) {
   return new Promise((resolve) => {
     const c = spawn(cmd, args, { stdio: ["ignore", "ignore", "pipe"] });
+    c.on("error", (err) => {
+      process.stderr.write(`[kahin] ${cmd} başlatılamadı: ${err.message}\n`);
+      resolve(1);
+    });
     c.stderr.on("data", (d) => process.stderr.write(`[kahin] ${d}`));
     c.on("close", (code) => resolve(code));
   });
@@ -372,5 +385,6 @@ function run(cmd, args) {
 
 if (process.argv[1] && process.argv[1].endsWith("setup.mjs")) {
   setup();
-  installPython();
+  const result = await installPython();
+  if (result?.error) process.exitCode = 1;
 }

package/docs/juggler-ai-native.md

@@ -141,8 +141,8 @@ Snapshot alanlarının anlamı:
 - `value`: input/textarea/select/contenteditable için gelir; password input
   değeri `[redacted]` olur.
 - `actions`: node'un doğrudan desteklediği `click`, `focus`, `type`, `select`
-  ipuçlarını gösterir. `select` bu ilk action yüzeyinde uygulanmaz; select
-  için mevcut DOM/evaluate veya daha özel tool sözleşmesini kullan.
+  ipuçlarını gösterir. `select` için `kahin_mirage_dom_action(action="select", text=...)`
+  option value veya görünen metinle gerçek input/change event'lerini gönderir.
 - `cursor`: o snapshot anındaki son sequence numarasıdır. Delta okumaya bu
   cursor'dan devam edilir.
 
@@ -212,9 +212,14 @@ Navigation document'ı yeniler ve nodeId'leri geçersiz kılar. Her frame'in
 document'ı kendi `streamId`'sine sahiptir; `frame_id` verilirse snapshot,
 event ve action aynı frame context'inde çalışır.
 
+Not: `reset`/`dropped` tespiti, çağrıya geçtiğiniz `stream_id` ile sayfadaki
+mevcut `streamId`'yi karşılaştırır. `dom_start`'ten aldığınız `streamId`'yi
+her `dom_events` çağrısında geçirin; `stream_id` verilmezse navigation sessiz
+kalır ve eski cursor yeni document'ın event'leriyle karışabilir.
+
 ### 3.4 Live action sözleşmesi
 
-İzin verilen action'lar: `click`, `hover`, `focus`, `type`, `scroll`.
+İzin verilen action'lar: `click`, `hover`, `focus`, `type`, `scroll`, `select`.
 
 - `click` ve `hover`, node'un gerçek viewport koordinatını ölçer ve
   `Page.dispatchMouseEvent` gönderir.
@@ -222,6 +227,8 @@ event ve action aynı frame context'inde çalışır.
   `text` zorunludur.
 - `focus`, canlı node'u focus eder.
 - `scroll`, node'u görünür alana `scrollIntoView` ile getirir.
+- `select`, `<select>` üzerinde option value veya görünen metinle eşleşir ve
+  gerçek `input`/`change` event'leri gönderir. `text` zorunludur.
 - Node bağlı değilse hiçbir replacement node'a fallback yapılmaz; yapılandırılmış
   `stale_node`/`requiresSnapshot` döner.
 
@@ -276,7 +283,7 @@ script'i ayrıca evaluate eder. Observer sayfa tarafında bounded olduğu için
 
 ## 6. Juggler tool kataloğu (A-Z)
 
-Aşağıdaki liste Mirage'ın 77 Juggler-native tool'unun tamamıdır. `MIRAGE`
+Aşağıdaki liste Mirage'ın 107 Juggler-native tool'unun tamamıdır. `MIRAGE`
 tool'ları `engine="mirage"` aktifken kullanılır.
 
 ### DOM gözlem ve adaptif action (5)
@@ -296,6 +303,15 @@ tool'ları `engine="mirage"` aktifken kullanılır.
 - `kahin_mirage_hover`, `kahin_mirage_get_html`
 - `kahin_mirage_wait_selector`, `kahin_mirage_get_value`
 
+### Reliability (9)
+
+- `kahin_mirage_expect`
+- `kahin_mirage_check`, `kahin_mirage_uncheck`
+- `kahin_mirage_select_option`, `kahin_mirage_dblclick`
+- `kahin_mirage_drag`
+- `kahin_mirage_wait_for_text`, `kahin_mirage_wait_for_timeout`
+- `kahin_mirage_route`
+
 ### Input (7)
 
 - `kahin_mirage_mouse_click`, `kahin_mirage_mouse_move`
@@ -308,11 +324,11 @@ tool'ları `engine="mirage"` aktifken kullanılır.
 - `kahin_mirage_reload`, `kahin_mirage_go_back`, `kahin_mirage_go_forward`
 - `kahin_mirage_stop`, `kahin_mirage_frame_tree`, `kahin_mirage_page_content`
 
-### Tab/session (6)
+### Tab/session (7)
 
 - `kahin_mirage_tab_new`, `kahin_mirage_tab_switch`, `kahin_mirage_tab_close`
 - `kahin_mirage_tab_list`, `kahin_mirage_tab_bring_front`
-- `kahin_mirage_context_new`
+- `kahin_mirage_context_new`, `kahin_mirage_context_close`
 
 ### Network/console (10)
 
@@ -359,10 +375,68 @@ frame'i bekler. Sayfa mutation'ı veya viewport değişiminden sonra görsel
 doğrulama için bu yol kullanılmalıdır; varsayılan `fresh=false` ise kuyruktaki
 en eski frame FIFO olarak döner.
 
-### Accessibility ve health (2)
+### Accessibility ve engine (3)
 
 - `kahin_mirage_accessibility_tree`
 - `kahin_engine_health`
+- `kahin_engine_stats` — monotonic clock ile uptime + healer tracker'dan
+  bounded per-tool rollup (`tool_calls`, `tool_errors`, `top_slow` ≤ 10,
+  `last_error`); Mirage aktifse `prewarm` metadata'sı; engine yoksa
+  yapılandırılmış `engine_unavailable` yanıtı (asla hata fırlatmaz)
+
+### Agent-native (10)
+
+- `kahin_mirage_snapshot` — canlı DOM ağacını token bütçeli, ref'li satırlara
+  çevirir; her ref canlı `nodeId`'dir ve `dom_action` üzerinde doğrudan
+  çalışır (`truncated` asla sessiz değildir)
+- `kahin_mirage_fill_form` — `{ref, text}` listesiyle birden fazla alanı
+  doldurur; stale ref `requiresSnapshot: true` ile döner
+- `kahin_mirage_state_save` / `kahin_mirage_state_load` — url + cookie +
+  local/sessionStorage'ı mutlak yola kaydeder/geri yükler (load önce
+  kaydedilen url'e gider; storage origin'e bağlıdır)
+- `kahin_identity_new` / `kahin_identity_save` / `kahin_identity_list` /
+  `kahin_identity_delete` — Camoufox fingerprint kimlikleri (yeni/manuel/
+  listele/sil); `kahin_browser_start(identity=...)` ile başlatmada uygulanır
+- `kahin_identity_report` — aktif engine'in kimlik özeti + sayfa-içi canlı
+  `navigator.userAgent` (set_user_agent onayından uydurulmaz)
+- `kahin_agent_status` — agent döngüsü özeti: engine/alive, url/title/
+  readyState, tabCount/currentTab, `refsLive` + `domCursor` (gerçek DOM-stream
+  bookkeeping; snapshot sonrası live, reset/dropped/stale/stop sonrası geçersiz),
+  pendingDialogs, networkEvents, consoleMessages, identity; engine yoksa
+  yapılandırılmış idle yanıt döner ve asla hata fırlatmaz
+
+### Stealth ve anti-detect (9)
+
+- `kahin_stealth_audit` — salt-okunur leak probe paketi (14 check: webdriver,
+  cdp-markers, binding-hidden, plugins, languages, platform, oscpu,
+  timezone-sane, screen-sane, prototype-integrity, permissions-api, webgl,
+  audio, hardware-concurrency); skor `{passed, total, ratio}` ile döner,
+  hiçbir check atlanmaz (bilinmeyen → fail + `detail:"unsupported"`)
+- `kahin_mirage_mouse_trajectory` — jitter'lı Bézier fare yörüngesi
+  (steps ≤ 200, jitter ≤ 20px, seed'li deterministik); bitiş noktası birebir
+  pinlenir
+- `kahin_mirage_click_humanized` — yörüngeli + insansı gecikmeli gerçek DOM
+  tıklaması (mousedown+mouseup)
+- `kahin_mirage_key_text` (çapraz liste) — jitter'lı tuş cadence'i ile metin yazma
+  (`delay_ms=0` → hızlı yol; gerçek keydown/keyup çiftleri); Input (7) altında
+  sayılır — tek kayıt, Stealth sayımına dahil değil
+- `kahin_identity_pin` / `kahin_identity_unpin` / `kahin_identity_pins` /
+  `kahin_identity_for_domain` — domain başına identity rotasyon politikası;
+  kanonik domain anahtarlı, bounded ve doğrulanmış `~/.config/kahin/pins.json`
+- `kahin_fingerprint_report` — canlı sayfa evaluate'sinden sitenin göreceği
+  fingerprint (userAgent/platform/oscpu/languages/timezone/locale/screen/
+  viewport/WebGL); kanıt her zaman sayfadan, asla emülasyon onayından gelmez
+- `kahin_proxy_resolve` — proxy üzerinden exit-IP geo çözümü +
+  timezone/locale/geolocation önerisi; URL'deki kimlik bilgileri asla
+  yankılanmaz; `browser_start(proxy=...)` ile gerçek proxy env uygulanır,
+  aktif engine config'iyle çakışma `engine_config_conflict` döner
+
+Stealth CI kapısı: `KAHIN_REQUIRE_STEALTH=1` altında audit ratio ≥ 0.8 ve
+identity rotasyonu tam fingerprint özetini değiştirmek zorundadır;
+`scripts/stealth-regression.py` drift-watcher'ı sabitlenmiş
+`camoufox-harness/tests/perf/stealth-baseline.json` ile karşılaştırır
+(0 = temiz, 1 = yeni leak, 2 = ortam; baseline yalnızca
+`KAHIN_UPDATE_BASELINE=1` ile yeniden yazılır).
 
 ## 7. Hazır akışlar
 
@@ -404,14 +478,16 @@ dom_events(after_seq=C, stream_id=S, frame_id=F, wait_ms=5000)
 
 | Hata/sinyal | Sebep | Kurtarma |
 |---|---|---|
-| `Browser engine is not running` | Start yok | `kahin_browser_start()` |
-| `Browser engine is dead` | Sidecar/Camoufox öldü | `kahin_browser_stop`, sonra yeni `start` |
+| `No browser engine running. Use kahin_browser_start first.` | Start yok | `kahin_browser_start()` |
+| `Browser engine is dead (crashed). Use kahin_browser_stop, then kahin_browser_start to restart.` | Sidecar/Camoufox öldü | `kahin_browser_stop`, sonra yeni `start` |
 | `stale_node` | Node silindi veya document değişti | Snapshot + yeni nodeId |
 | `reset`/`dropped` | Stream değişti veya ring overflow | Snapshot; eski cursor'u bırak |
 | `not_found` | Selector artık yok | Event/snapshot ile yeni hedef bul |
 | `truncated` | Snapshot cap'i küçük | Selector veya cap daralt/genişlet |
 | `unsupported_action` | Action allow-list dışında | Yalnızca desteklenen action kullan |
 | `not_text_input` | Hedef textbox değil | Role/name/action ipuçlarını tekrar değerlendir |
+| `not_select` | `action=select` hedefi `<select>` değil | Snapshot'taki action ipuçlarını tekrar değerlendir |
+| `option_not_found` | Option value/görünen metin eşleşmedi | Snapshot/events ile option value'larını doğrula, `text`'i düzelt |
 | `Method not found` | Juggler'da CDP methodu yok/yanlış | Validate + get command/dependency; native Mirage tool seç |
 
 Hata alınca aynı hatayı körlemesine tekrarlama. Önce state'i yeniden oku,
@@ -421,6 +497,22 @@ gerekirse `kahin_error_decode` ve `kahin_get_dependencies` kullan.
 
 - DOM snapshot ve event payload'ları cap'lidir; bounded sonuçlar ajana açıkça
   `truncated`, `pending`, `reset` ve `dropped` durumlarını verir.
+- Sidecar istek işleme non-blocking'dir: birden fazla istek aynı anda
+  in-flight olabilir, stdin işleme browser yanıtını asla bloklamaz; IPC
+  sözleşmesi (id-matching, event forwarding, timeouts, death detection)
+  değişmez. N=20 `Runtime.evaluate` concurrency probe'u
+  `camoufox-harness/tests/perf/concurrency.md`'dedir (paralel duvar
+  56.89 → 8.71 ms, ratio 1.314 → 3.281).
+- `kahin_engine_stats` `top_slow` değeri ortalama süreye göre en yavaş 10
+  araçla sınırlıdır; tracker process-genelidir, bu yüzden tek bir hızlı
+  aracın listede olması garanti edilmez (rollup şekli ve `tool_calls`
+  sayaçları güvenilir sinyallerdir).
+- Identity profile prewarm bir **metadata/reuse kaydıdır**, cache değildir:
+  stabil identity hash + ölçülen hazırlık süreleri (`options_ms`,
+  `profile_ms`, `hits`, `starts`) in-process (max 8, FIFO) ve
+  `~/.cache/kahin/profiles/<hash>.json` içinde (≤ 4 KiB, tmp+rename) tutulur;
+  gerçek launch işi asla atlanmaz (per-launch rastgelelik korunur) ve
+  metadata kimlik payload'ı içermez.
 - Password input değerleri snapshot/event descriptor'larında redacted olur.
 - `attributes` tam HTML değildir; güvenli kimlik ve erişilebilirlik alanlarıyla
   sınırlıdır. Tam HTML gerekiyorsa bunun maliyetini bilerek

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahinmcp/kahin",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Kahin \u2014 CDP ansiklopedisi + anti-detect browser otomasyon MCP sunucusu. Kurulumda 22 AI CLI arac\u0131n\u0131 otomatik tespit edip kendini kaydeder. Camoufox g\u00f6rsel varsay\u0131land\u0131r; Obscura h\u0131zl\u0131 CDP i\u015fleri i\u00e7in opt-in'dir.",
   "bin": {
     "kahin": "bin/kahin.mjs"