@kahinmcp/kahin 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 Tüm önemli değişiklikler bu dosyada tutulur. Format: [Keep a Changelog](https://keepachangelog.com/tr/1.1.0/) — [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.2] — 2026-08-05
+
+### Düzeltilen
+- Camoufox/Mirage artık aynı browser sürecini ve sekmeleri yeniden kullanıyor; tekrar eden `browser_start` çağrıları ikinci browser açmıyor.
+- Başlangıç, sağlık kontrolü ve stop timeout'larında sidecar/Camoufox orphan süreçleri temizleniyor.
+- Mirage araçlarının ilk sekme yokken timeout olması düzeltildi; eşzamanlı ilk çağrılar tek sekmeye birleşiyor.
+- CDP çağrıları Target/Input/Emulation/Network eşdeğerlerine otomatik yönlendiriliyor ve CDP biçimli sonuç döndürüyor.
+- Eşzamanlı Juggler çağrılarında yanlış pending request silinmesi düzeltildi.
+
+### Testler
+- Python uygulama testleri: 106 passed
+- Zig sidecar testleri: passed
+
 ## [0.3.0] — 2026-08-03
 
 ### Eklenen
@@ -80,6 +93,7 @@ Tüm önemli değişiklikler bu dosyada tutulur. Format: [Keep a Changelog](http
 - Zig Juggler harness: pipe transport, Browser/Page/Runtime/Network/Input/Emulation adapters, interception, process manager, perf + crash-recovery
 - CDP ansiklopedisi: 56 domain, 667 komut, 237 event, 609 type (Chrome 148)
 
+[0.3.2]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.3.1...v0.3.2
 [0.2.0]: https://gitlab.com/void0x14/kahin-mcp/-/compare/v0.1.8...v0.2.0
 [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

package/README.md

@@ -101,6 +101,13 @@ Camoufox (Juggler native) ile, engine `mirage` seçilince:
 → kahin_mirage_accessibility_tree → kahin_engine_health
 ```
 
+`kahin_browser_start` tek bir Camoufox/sidecar süreci açar. İlk sayfa işlemi
+aynı süreç içinde varsayılan bir sekmeyi tembel olarak oluşturur; sonraki işler
+bu sekmeyi yeniden kullanır. Ayrı bir sayfa gerektiğinde yeni tarayıcı başlatmak
+yerine `kahin_mirage_tab_new` ve `kahin_mirage_tab_switch` kullanın. Camoufox
+aktifken `kahin_execute_cdp` ve diğer CDP araçları, eşdeğer Juggler/Mirage
+çağrısına otomatik yönlendirilir ve CDP biçimli sonuç döndürür.
+
 Tam liste için: [AGENTS.md](AGENTS.md)
 
 ## Proje Felsefesi

package/bin/kahin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-// kahin global launcher — kod tabanındaki kahin MCP server'ı çalıştırır.
-// Kurulum: pnpm add -g @kahinmcp/kahin
+// kahin global launcher — gömülü wheel'den kahin MCP server'ı çalıştırır.
+// Kurulum: pnpm add -g @kahinmcp/kahin  (postinstall venv + wheel kurar)
 
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
@@ -20,6 +20,13 @@ function sh(cmd, args, opts = {}) {
 }
 
 async function setup() {
+  // venv yoksa gömülü wheel'den kur (postinstall atlanmışsa / bozuksa)
+  const { installPython } = await import("./setup.mjs");
+  const res = await installPython();
+  if (res && res.error) {
+    process.stderr.write(`[kahin] python kurulumu başarısız (çıkış ${res.error})\n`);
+    process.exit(1);
+  }
   const python = existsSync(PY) ? PY : (process.env.KAHIN_PY || "python3");
   const check = await sh(python, ["-c", "import kahin"], { stdio: ["ignore", "pipe", "pipe"] });
   if (check !== 0) {
@@ -32,8 +39,8 @@ async function setup() {
 const args = process.argv.slice(2);
 
 if (args[0] === "setup") {
-  const { setup } = await import("./setup.mjs");
-  setup();
+  const { setup: registerClients } = await import("./setup.mjs");
+  registerClients();
   process.exit(0);
 }
 

package/bin/setup.mjs

@@ -10,6 +10,8 @@
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, dirname } from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 const HOME = homedir();
 const isWin = process.platform === "win32";
@@ -319,6 +321,56 @@ export function setup() {
   return { installed };
 }
 
+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.2-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.
+export async function installPython() {
+  if (process.env.KAHIN_SKIP_PYTHON) {
+    log("python kurulumu atlandı (KAHIN_SKIP_PYTHON)");
+    return { skipped: true };
+  }
+  if (!existsSync(KAHIN_WHEEL)) {
+    log(`wheel bulunamadı: ${KAHIN_WHEEL} — kurulum atlandı (geliştirme ortamı?)`);
+    return { skipped: true };
+  }
+  const python3 = process.env.KAHIN_PYTHON || "python3";
+  const args = ["-m", "venv", KAHIN_VENV];
+  if (!existsSync(join(KAHIN_VENV, "pyvenv.cfg"))) {
+    log(`venv oluşturuluyor: ${KAHIN_VENV}`);
+    const code = await run(python3, args);
+    if (code !== 0) {
+      log(`venv oluşturulamadı (${python3} ${args.join(" ")} — çıkış ${code})`);
+      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 };
+}
+
+function run(cmd, args) {
+  return new Promise((resolve) => {
+    const c = spawn(cmd, args, { stdio: ["ignore", "ignore", "pipe"] });
+    c.stderr.on("data", (d) => process.stderr.write(`[kahin] ${d}`));
+    c.on("close", (code) => resolve(code));
+  });
+}
+
 if (process.argv[1] && process.argv[1].endsWith("setup.mjs")) {
   setup();
+  installPython();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kahinmcp/kahin",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Kahin — CDP ansiklopedisi + anti-detect browser otomasyon MCP sunucusu. Kurulumda 22 AI CLI aracını otomatik tespit edip kendini kaydeder. Obscura ve Camoufox motorlarını kullanır, motor seçimini ajana bırakır.",
   "bin": {
     "kahin": "bin/kahin.mjs"
@@ -11,8 +11,10 @@
   },
   "files": [
     "bin",
+    "lib",
     "LICENSE",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "README.md"
   ],
   "engines": {
     "node": ">=18"