@kahinmcp/kahin 0.3.6 → 0.3.7

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [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 +198,4 @@ 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

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
+## 110 Tool · 4 Kategori Ailesi · 2 Engine
 
 Tool'lar engine-ayrımlı kategori dosyalarında (`kahin/tools/`): paylaşılan çekirdek + Obscura + Camoufox aileleri.
 
@@ -32,7 +32,7 @@ Tool'lar engine-ayrımlı kategori dosyalarında (`kahin/tools/`): paylaşılan
 |  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 |
 |  OBSCURA — Ayrı kategori | Obscura'ya özel tool'lar (hazırlanıyor) | 0 |
 
-**Toplam: 109 tool.**
+**Toplam: 110 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
 
@@ -156,14 +158,14 @@ 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/                → 110 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)
+    pilot_obscura/trainman_obscura/dejavu_obscura → Shadow için ayrılmış paket sınırları; sahte tool kaydetmez
     engine.py           → engine_health
   _healer.py            → Hata yönetimi, loglama, kendini onarma
   the_source/architect  → CDP şema motoru (56 domain, 667 komut)
@@ -185,7 +187,7 @@ 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ı 110** — Camoufox Juggler-native 78 tool (gerçek-zamanlı DOM stream, DOM, Input, Network, Storage, Emulation, Dialog, Tab, Worker/WS, Upload, Screencast, Accessibility) + paylaşılan 32 çekirdek
 - [ ] **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 +209,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.7-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.
 
@@ -276,7 +276,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 78 Juggler-native tool'unun tamamıdır. `MIRAGE`
 tool'ları `engine="mirage"` aktifken kullanılır.
 
 ### DOM gözlem ve adaptif action (5)
@@ -308,11 +308,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)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahinmcp/kahin",
-  "version": "0.3.6",
+  "version": "0.3.7",
   "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"