@appaflytech/zeyrek-ai-mcp 0.0.49 → 0.0.50

package/dist/tools/mobileStore.js

@@ -5,9 +5,14 @@ import { destructive, environmentParam, guid, projectParam, readOnly, updates, w
 import { unwrap } from './screens.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
+import { launchScreenshotBrowser } from '../platform/capture/capture.js';
+import { previewStoreArt, sharedGalleryServer } from '../platform/storeArt/gallery.js';
+import { EYEBROW_MAX, MAX_STYLES, SUBTITLE_MAX, TITLE_MAX } from '../platform/storeArt/deck.js';
+import { LAYOUT_IDS } from '../platform/storeArt/layouts.js';
+import { STYLE_IDS } from '../platform/storeArt/styles.js';
 import { attachFindings, enforcePolicy, evaluatePolicy } from '../knowledge/policy.js';
 import { policyRules } from '../knowledge/rules.js';
-import { APPLE_RELEASE_TYPES, ASSET_KINDS, BUILD_ASSET_KINDS, DECLARATION_KEYS, DEVICE_CLASSES, MAX_ASSET_BYTES, ORIENTATIONS, PLAY_TRACKS, RELEASE_STATUSES, SCREENSHOT_CAPTURE_DEVICES, SPLASH_RESIZE_MODES, USER_INTERFACE_STYLES, adsStoreWarnings, trackingDeclarationWarnings, assetSlotProblem, changedStoreFields, mergeStoreSettings, permissionLaunchShellWarnings, permissionLockShellWarnings, permissionStoreBuildWarnings } from '../knowledge/mobileStore.js';
+import { APPLE_RELEASE_TYPES, ASSET_KINDS, BUILD_ASSET_KINDS, COLOR_PATTERN, DECLARATION_KEYS, DEVICE_CLASSES, LOCALE_PATTERN, MAX_ASSET_BYTES, MAX_IMAGES_PER_SLOT, ORIENTATIONS, PLAY_TRACKS, RELEASE_STATUSES, SCREENSHOT_CAPTURE_DEVICES, SPLASH_RESIZE_MODES, USER_INTERFACE_STYLES, adsStoreWarnings, trackingDeclarationWarnings, assetSlotProblem, changedStoreFields, mergeStoreSettings, permissionLaunchShellWarnings, permissionLockShellWarnings, permissionStoreBuildWarnings } from '../knowledge/mobileStore.js';
 /**
  * Mobil mağaza yayınının ajan yolu (`plans/mobil-magaza-yayini` g-11, `plans/mobil-yayin-mcp` g-01):
  * gizli olmayan mağaza ayarı, mağaza görselleri, beyanlar ve derleme işi. Gizli bilgi (Apple/Google
@@ -290,6 +295,27 @@ async function readAsset(kind, path, content, filename) {
     const extension = png ? 'png' : 'jpg';
     return { bytes, name: filename ?? (path !== undefined ? basename(path) : `${kind}.${extension}`), contentType: png ? 'image/png' : 'image/jpeg' };
 }
+/**
+ * `mobile_asset_create`'in yükleme yolu; galeri sayfasının "Seçilenleri yükle"si de bunu çağırır (ADR 0004),
+ * böylece yuva kuralı ve biçim denetimi iki yolda aynıdır.
+ */
+async function uploadStoreAsset(platform, appId, { kind, path, content, filename, locale, deviceClass }) {
+    // Backend boş dili null sayar (`MobileStoreService.UploadAssetAsync`); data URL öneki base64 değildir.
+    const slotLocale = locale?.trim() ? locale.trim() : undefined;
+    const problem = assetSlotProblem(kind, slotLocale, deviceClass);
+    if (problem)
+        throw new PlatformApiError(`mobile_asset_create: ${problem}. Hiçbir şey yüklenmedi.`, 400);
+    const file = await readAsset(kind, path, content?.replace(/^data:[^,]*;base64,/, ''), filename);
+    const asset = unwrap(await platform.org('POST', `/mobile-store/${appId}/assets`, {
+        multipart: [
+            { name: 'file', filename: file.name, contentType: file.contentType, content: file.bytes },
+            { name: 'kind', value: kind },
+            ...(slotLocale === undefined ? [] : [{ name: 'locale', value: slotLocale }]),
+            ...(deviceClass === undefined ? [] : [{ name: 'deviceClass', value: deviceClass }])
+        ]
+    }));
+    return { ...assetSummary(asset), ...(kind === 'screenshot' || kind === 'promo' ? {} : { note: `'${kind}' tekli yuvadır: varsa önceki görsel silindi.` }) };
+}
 const captureTable = DEVICE_CLASSES.map(deviceClass => {
     const device = SCREENSHOT_CAPTURE_DEVICES[deviceClass];
     return `${deviceClass} → device { width: ${device.width}, height: ${device.height}, scale: ${device.scale} } (${device.width * device.scale}×${device.height * device.scale})`;
@@ -356,8 +382,10 @@ function buildSummary(job, now) {
         ...(isObject(job.error) ? { next: `Hata kodu → öneri: platform_guide('mobile-publish', 'hata-kodlari'); ayrıntı mobile_build_log` } : {})
     };
 }
-export function registerMobileStoreTools(server, platform) {
+export function registerMobileStoreTools(server, platform, storeArt = {}) {
     const config = platform.config;
+    const launchStoreArtBrowser = storeArt.launcher ?? (() => launchScreenshotBrowser(config));
+    const galleryServer = storeArt.gallery ?? sharedGalleryServer;
     server.registerTool('mobile_store_get', {
         title: 'Mobil mağaza ayarını oku',
         description: "Mobil uygulamanın gizli olmayan mağaza ayarını döner (GET mobile-store/{appId}): kimlik (bundleIdentifier, androidPackage, scheme), sürüm ve sayaçlar, görünüm, izin metinleri, kipleri ve açılışta sorulanlar (permissions, permissionModes, launchPermissions), listing (dil başına mağaza metni), urls, apple, play, review; lockedFields (ilk derlemeden sonra değişmeyen alanlar), görsel yuvası başına sayı (assets: 'screenshot/tr/iphone69': 3) ve beyanlar (declarations: anahtar → işaretli mi); settings.ads reklam ayarıdır (kök ADR 0012: enabled, App ID'ler, testMode, consentForm, appOpenUnit, units[] = adBanner.unit ve ad-show.value'nun andığı yerleşimler) ve reklam açıkken adsWarnings döner (MOB-026: test kipi, platformda birimsiz yerleşim, konsol beyanları); settings.appLock uygulama kilididir (kök ADR 0021: enabled, timeoutSeconds 0·60·300·900). Kayıt hiç yazılmamışsa persisted:false ve VARSAYILANLAR döner (kaydedilmez). manifest:true derlemeye gidecek manifesti de ekler (manifest-preview; sayaçlar SIRADAKİ numara); üretilemiyorsa manifestError alan adıyla döner. detail ayrıntı bölümleri ekler: 'assets' görselleri id'li liste olarak döner (mobile_asset_update / mobile_asset_delete id ister), 'signing' uygulamanın kimlik bilgilerini (signing.app: iOS profili, Android keystore, harita anahtarı, demo hesabı) ve organizasyonun Apple/Google hesaplarını + sertifikalarını (signing.accounts), 'runners' çevrimiçi runner'ları, 'audit' son 20 gizli bilgi olayını (subject: hangi tür, kim, ne zaman, hangi iş), 'permissions' izin görünümünü (permissions.permissions[]: uygulamanın isteyebileceği her izin için mode, text/defaultText, usage — izni kullanan sayfa·bileşen ya da akış adımı (setter ile yazılan tetikleyici prop dahil), ilk 20 yer + usageCount, çağrının environment'ından; usageReadable false ise o ortam okunamamıştır ve boş usage 'kullanılmıyor' demek değildir —, build — mağaza derlemesi taşıyor mu ve neden; HER ZAMAN production'dan: build.usageCount production'daki kullanım, build.staticUsageCount onun yazılı (ifadesiz) kısmı —, devices — aktif cihazların izin durumu sayıları; missingFromStoreBuilds — o izni taşımayan son mağaza derlemeleri; shell.carriesPermissions false ise kipler ve kabuğun henüz taşımadığı izinler bir sonraki kabuk sürümüyle etkili olur; shell.carriesLaunchPermissions false ise açılışta sorulan izinler (askOnLaunch) o kabukta sorulmaz, shell.carriesAppLock false ise açık uygulama kilidi o kabukta yoktur — permissionWarnings söyler), 'status' mağaza durumunu (GET store-status: apple { state, appStoreState, versionString, releaseType, phased* }, play.tracks[] { track, status, versionCodes, rolloutPercent }, actions[] { platform, target, track, irreversible, consequence } — Studio › Yayınla'daki yayın düğmeleri; irreversible:true geri alınamaz, eylemi MCP başlatmaz, kullanıcıya consequence'ı söyleyip Studio'ya yönlendirin), 'changes' son production dağıtımından beri değişenleri iki kovada (GET changes-since-production: live — dağıtımla telefonlara gider, mağaza gerekmez; store — izin/kimlik/görsel gibi yeni mağaza sürümü isteyenler). Gizli DEĞER hiçbir bölümde yoktur — yalnız tür, maskeli id ve meta (ekip, son kullanma); bir bölüm okunamazsa (uç hatası) <bölüm>Error döner, çağrı düşmez. Gizli bilgiyi EKLEMEK/DEĞİŞTİRMEK MCP'den yapılmaz — Studio › Yayın › Hesaplar.",
@@ -575,23 +603,32 @@ export function registerMobileStoreTools(server, platform) {
         // Tekli yuvada önceki görsel ve dosyası silinir (`MobileStoreService.UploadAssetAsync`): geri alınamaz.
         // Ekran görüntüsü eklendiği için idempotent değildir.
         annotations: { ...writes, destructiveHint: true }
-    }, handle(config, async ({ applicationId: appId, path, content, filename, kind, locale, deviceClass }) => {
-        // Backend boş dili null sayar (`MobileStoreService.UploadAssetAsync`); data URL öneki base64 değildir.
-        const slotLocale = locale?.trim() ? locale.trim() : undefined;
-        const problem = assetSlotProblem(kind, slotLocale, deviceClass);
-        if (problem)
-            throw new PlatformApiError(`mobile_asset_create: ${problem}. Hiçbir şey yüklenmedi.`, 400);
-        const file = await readAsset(kind, path, content?.replace(/^data:[^,]*;base64,/, ''), filename);
-        const asset = unwrap(await platform.org('POST', `/mobile-store/${appId}/assets`, {
-            multipart: [
-                { name: 'file', filename: file.name, contentType: file.contentType, content: file.bytes },
-                { name: 'kind', value: kind },
-                ...(slotLocale === undefined ? [] : [{ name: 'locale', value: slotLocale }]),
-                ...(deviceClass === undefined ? [] : [{ name: 'deviceClass', value: deviceClass }])
-            ]
-        }));
-        return { ...assetSummary(asset), ...(kind === 'screenshot' || kind === 'promo' ? {} : { note: `'${kind}' tekli yuvadır: varsa önceki görsel silindi.` }) };
-    }));
+    }, handle(config, ({ applicationId: appId, ...upload }) => uploadStoreAsset(platform, appId, upload)));
+    const hexColor = z.string().regex(COLOR_PATTERN, "Renk '#RRGGBB' biçiminde verilir");
+    server.registerTool('mobile_asset_preview', {
+        title: 'Mağaza pazarlama görseli çiz',
+        description: "Ham ekran görüntülerini mağaza pazarlama görseline çizer ve aynı kareleri en çok dört hazır stilde yan yana üretir (çeşitleme). Stiller (styles): clean (açık düz), midnight (koyu gradyan + parıltı), aurora (renkli ışık lekeleri), spotlight (koyu + merkez ışık), swiss (ızgara, sola hizalı büyük harf), japandi (kırık beyaz + serif), pastel (yumuşak gradyan + yuvarlak yazı), neon (siyah nokta deseni + neon vurgu). Kare başına yerleşim (slides[i].layout): classic (cihaz ortada), bleed (büyük cihaz alttan taşar, başlık üstte), tilt (3D eğik cihaz), text (cihazsız büyük başlık; path istemez). Çerçeve CSS'tir (Apple görseli değil); çıktı deviceClass'ın mağaza ölçüsünde alfasız JPEG'dir (iphone69 1320×2868, ipad13 2064×2752, phone 1080×2160, tablet7 1200×1920, tablet10 1600×2560), dosya adı <stil>-NN.jpg; kartlar kare sırasıyla (her karenin stilleri yan yana) dizilir ve bu sıra yükleme sırasıdır. Girdi: her kare için page_screenshot { environment: 'production', device, format: 'jpeg', language: <locale>, colorScheme: 'light', outPath } çıktısının yolu; araç sayfa ÇEKMEZ. Platforma kendisi hiçbir şey YAZMAZ: dosyalar yanıttaki directory'ye yazılır ve yanıt galleryUrl taşır (http://127.0.0.1:<port>/g/<anahtar>/) — adresi KULLANICIYA verin; sayfa bir EDİTÖRDÜR: kullanıcı başlığı karenin üstünde yazarak değiştirir, stil/yerleşim/renk/ham kare seçer, kartı kopyalar, sırayı sürükleyerek değiştirir, kartı yeniden çizer ve seçtiklerini 'Seçilenleri yükle' ile screenshot/<locale>/<deviceClass> yuvasına deste sırasıyla ekler (kendiniz ayrıca yüklemeyin, yuvaya kopya düşer). Kullanıcının düzenlemeleri directory/deck.json'dadır. Galeri gateway süreci yaşadıkça açıktır; AUTH_MODE=passthrough'ta galeri açılmaz ve yükleme mobile_asset_create { path: files[i].path, kind: 'screenshot', deviceClass, locale } ile yapılır. Tuzaklar: kare deviceClass'ın cihaz ölçüsüyle çekilmediyse ekrana kırpılarak oturur ve warnings söyler; başlık en çok iki satır (text'te beş), alt başlık iki satır çizilir, taşan metin kesilir; başlık uygulamanın gerçekten yaptığını söyler (App Review 2.3.7: fiyat, sıralama, rakip adı yok) ve kare o yuvanın dilinde çekilmiş olmalıdır; yazı tipleri işletim sisteminindir. Uygulamanın rengi palette ile stillere uygulanır (theme_get).",
+        inputSchema: {
+            applicationId,
+            deviceClass: z.enum(DEVICE_CLASSES).describe("Yuvanın cihaz sınıfı: iphone69 (iPhone 6.9\"), ipad13 (iPad 13\"), phone, tablet7, tablet10 (Play). Ham kareler page_screenshot'a bu sınıfın device'ıyla çekilir"),
+            locale: z.string().regex(LOCALE_PATTERN).describe("Yuvanın dili ('tr', 'en-US'); başlıklar bu dilde yazılır, ham kareler page_screenshot { language } ile bu dilde çekilir"),
+            slides: z.array(z.object({
+                path: z.string().min(1).optional().describe("Ham karenin yerel yolu (page_screenshot outPath); layout 'text' dışında zorunlu"),
+                eyebrow: z.string().trim().min(1).max(EYEBROW_MAX).optional().describe('Başlığın üstündeki küçük büyük harf etiket (ör. "Planla")'),
+                title: z.string().trim().min(1).max(TITLE_MAX).describe("Başlık; en çok iki satır ('text' yerleşiminde beş) çizilir"),
+                subtitle: z.string().trim().min(1).max(SUBTITLE_MAX).optional().describe('Alt başlık; en çok iki satır çizilir'),
+                layout: z.enum(LAYOUT_IDS).optional().describe("Yerleşim; varsayılan 'classic'. Ardışık karelerde yerleşimi değiştirmek seriyi canlı gösterir")
+            })).min(1).max(MAX_IMAGES_PER_SLOT).describe(`Kareler mağazadaki sırayla; yuva en çok ${MAX_IMAGES_PER_SLOT} görsel alır`),
+            styles: z.array(z.enum(STYLE_IDS)).min(1).max(MAX_STYLES).optional().describe("Çizilecek stiller (tekrarsız, 1–4); her kare her stilde çizilir ve galeride stil başına bir satır olur. Varsayılan ['clean']"),
+            palette: z.object({
+                primary: hexColor.optional().describe('Stillerin vurgu rengi (üst etiket, parıltı, aurora lekeleri); uygulamanın ana rengi'),
+                text: hexColor.optional().describe('Başlık rengi; stilin zeminiyle yeterli karşıtlıkta seçin')
+            }).optional(),
+            captionPosition: z.enum(['top', 'bottom']).optional().describe("classic ve tilt'te başlığın yeri; varsayılan 'top' (bleed hep üst, text ortada)"),
+            frame: z.boolean().optional().describe('false: çerçevesiz, köşeleri yuvarlatılmış gölgeli ekran; varsayılan true')
+        },
+        annotations: readOnly
+    }, handle(config, ({ applicationId: appId, ...input }) => previewStoreArt(launchStoreArtBrowser, config, galleryServer, input, file => uploadStoreAsset(platform, appId, { kind: 'screenshot', path: file, locale: input.locale, deviceClass: input.deviceClass }))));
     server.registerTool('mobile_asset_update', {
         title: 'Mağaza görsellerini sırala',
         description: "Bir yuvadaki görsellerin sırasını yazar (PUT mobile-store/{appId}/assets/order): dizideki sıra mağazadaki gösterim sırası olur (ilk ekran görüntüsü mağazada önce görünür). assetIds TEK yuvanın (ör. 'screenshot/tr/iphone69') BÜTÜN görsellerini içerir — backend her id'ye dizideki indeksini yazar ve yuvayı denetlemez; eksik liste ya da iki yuvanın karışımı sessizce çakışan sıra üretirdi, bu yüzden gateway istek gitmeden kaydı okur ve bunları durdurur. Id'ler: mobile_store_get { detail: ['assets'] }.",

package/dist/tools/pages.js

@@ -300,12 +300,14 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             layoutReport: z.boolean().optional().describe("true: kareyle birlikte her runtime düğümünün efektif piksel kutusunu ve özetini (taşan / viewport dışı / sıfır boyutlu elementId'ler) döner — taşma ve çakışmayı görüntüsüz, sayısal yakalar. Mobil uygulamada özet ayrıca layoutSummary.alignment taşır: gutter (ekran kenarı boşluğu), leftEdges (aynı kapsamdaki geniş içeriğin sol kenar kümeleri — sözleşmede tek küme), surfaces (iç hizası bozuk yüzey kapları), widthOutliers (sağ kenarı sapan geniş öğeler, içeri itilme dp'si), offScaleGaps (0/4/8/16/24/32 dışı dikey aralıklar). Yan yana dizilen, ekran dışında kalan ve akış dışı (app-bar, fab, modal…) öğeler kıyasa girmez. Düğümler data-element-id taşımıyorsa layoutReportUnavailable döner."),
             cookies: z.record(z.string()).optional().describe("Tarayıcıya enjekte edilecek EK çerezler (ad → değer): uygulamanın kendi oturum çerezi buraya verilir. Aynı ada sahip çerez gateway jetonunun yerine geçer. anonymous ile birlikte verilemez."),
             actions: z.array(z.object({
-                action: z.enum(['set', 'click', 'wait', 'drag', 'tab', 'select', 'submit']),
-                target: z.string().min(1).optional().describe("Hedefin elementId'si (page_schema_get); runtime düğümü data-element-id ile bulunur. 'drag' için sürüklenen öğe (ör. 'kb_board__card-42', 'cal_plan__event-7'); 'tab' için sekme GRUBUNUN kendisi ('tabs_settings'), 'select' için açılır kutu, 'submit' için form komponenti"),
-                to: z.string().min(1).optional().describe("Yalnız 'drag': bırakma hedefinin elementId'si — kanban kolonu '<elementId>__col-<value>', takvim günü '<elementId>__day-<yyyy-MM-dd>', tüm gün hücresi '<elementId>__allday-<yyyy-MM-dd>', saat dilimi '<elementId>__slot-<yyyy-MM-dd>T<HH>'"),
+                action: z.enum(['set', 'click', 'wait', 'drag', 'swipe', 'tab', 'select', 'submit']),
+                target: z.string().min(1).optional().describe("Hedefin elementId'si (page_schema_get); runtime düğümü data-element-id ile bulunur. 'drag' için sürüklenen öğe (ör. 'kb_board__card-42', 'cal_plan__event-7'); 'swipe' için jestin basıldığı öğe (ör. tutamaç 'lst__row-2__handle', satır 'lst__row-3'); 'tab' için sekme GRUBUNUN kendisi ('tabs_settings'), 'select' için açılır kutu, 'submit' için form komponenti"),
+                to: z.string().min(1).optional().describe("'drag' ve 'swipe': bırakma hedefinin elementId'si ('swipe'ta jest hedefin içinde, hareket yönündeki kenarına 2 px kala biter — sıralamada satır tam hedefin yerine iner; dx/dy ile birlikte verilmez) — kanban kolonu '<elementId>__col-<value>', takvim günü '<elementId>__day-<yyyy-MM-dd>', tüm gün hücresi '<elementId>__allday-<yyyy-MM-dd>', saat dilimi '<elementId>__slot-<yyyy-MM-dd>T<HH>'"),
                 value: z.unknown().optional().describe("'set' için yazılacak değer. Tarih kutularına ISO yazın ('2026-08-01'); çok alanlı tarih aralığında kök DEĞİL kutu hedeflenir: '<elementId>__start' / '<elementId>__end'. 'tab' için sekmenin ANAHTARI ('iot') ya da görünen metni; 'select' için seçeneğin value'su ya da görünen metni"),
-                ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi")
-            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. Autocomplete'te 'set' metni alana yazar, 'select' metni yazıp öneri satırını GÖRÜNEN METİNLE seçer (value ile değil; eşleşme yoksa yazılan metin alanda kalır ve note bunu söyler). 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
+                ms: z.number().int().min(0).max(15000).optional().describe("'wait' için bekleme süresi"),
+                dx: z.number().optional().describe("Yalnız 'swipe': jestin yatay kayması (CSS pikseli; sola kaydırma eksi). to ile birlikte verilmez"),
+                dy: z.number().optional().describe("Yalnız 'swipe': jestin dikey kayması (CSS pikseli; yukarı eksi). to ile birlikte verilmez")
+            })).max(20).optional().describe("Kare ALINMADAN ÖNCE sayfada koşturulacak etkileşim adımları: [{action:'set', target:'flt_month', value:'2022-10'}, {action:'click', target:'btn_sign_in'}, {action:'tab', target:'tabs_settings', value:'iot'}, {action:'select', target:'dd_city', value:'34'}, {action:'submit', target:'frm_note'}, {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}]. 'tab' SEKME SEÇER: sekme grubunun köküne 'click' göndermek DOM sırasındaki İLK sekmeye gider ve ikinci sekme hiç açılamıyordu — tablist köküne click artık reddedilir ve bu fiile yönlendirir. Eşleme önce '<elementId>__tab-<sekme anahtarı>' kimliğiyle, o yoksa görünen metinle yapılır; actionsReport.matchedBy hangisi olduğunu, actionsReport.activeTab adımdan SONRA hangi sekmenin açık olduğunu söyler. Etkin olmayan sekmenin içeriği DOM'da YOKTUR: o sekmedeki bir düğüme yazmadan önce 'tab' adımı gerekir. 'select' açılır kutudan seçer — kutu native alan değildir, değeri yazmak hiçbir şey yapmaz, seçeneğe tıklanması gerekir; liste 3 sn'ye kadar YOKLANIR (sorgudan beslenen kutuda seçenekler geç basılır) ve actionsReport.optionsSeen + waitedMs neyin görüldüğünü söyler. Autocomplete'te 'set' metni alana yazar, 'select' metni yazıp öneri satırını GÖRÜNEN METİNLE seçer (value ile değil; eşleşme yoksa yazılan metin alanda kalır ve note bunu söyler). 'submit' formu gönder butonu OLMADAN gönderir (form.requestSubmit); actionsReport.submitVia hangi yolun kullanıldığını yazar. 'drag' HTML5 sürükle-bırak olaylarını (dragstart→dragover→drop→dragend) hedefin merkezinde atar; kanban cardMove ve takvim eventMove bununla tetiklenir. 'swipe' DOKUNMATİK jesttir (mobil): hedefin merkezine basar, 12 adımda 16 ms arayla taşır ve bırakır (pointer + mouse olayları; sıfır kayma reddedilir — dokunuş 'click'tir) — tutamaçtan sıralama {action:'swipe', target:'lst__row-2__handle', to:'lst__row-0'}, satır kaydırma eylemi {action:'swipe', target:'lst__row-1', dx:-160, dy:0}; 'drag' web'in HTML5 sürüklemesi, 'swipe' dokunmatik jest. 'set' native setter kullanır ve input+change olaylarını bubbles ile atar (düz DOM ataması framework'ün duyduğu olayı üretmez); ardından kök düğümün runtime prop'larını yeniden okur: actionsReport.propWritten değerin prop'a ULAŞIP ulaşmadığıdır ve false ise applied da false döner — DOM'a yazılmış ama bileşenin duymadığı değer 'uygulandı' sayılmaz (G-14). Her adımdan sonra yerleşme beklenir ve yanıttaki actionsReport hedefin bulunup bulunmadığını ve adımdan sonra KAÇ AĞ İSTEĞİ çıktığını söyler — 'bağ kuruldu' ile 'çalışıyor' arasındaki farkı ancak bu ayırır (G-24)."),
             language: z.string().min(1).optional().describe("Kareyi BU DİLDE çeker: adrese '?lang=<kod>' eklenir ve runtime dili oradan seçer (öncelik: ?lang → tarayıcıda kayıtlı seçim → tarayıcı dilleri → projenin varsayılanı). Seçim hem çeviriye bağlı prop'ları hem çok dilli alanların satır değerlerini kapsar, yani ikinci dilin karesi için sayfaya dil değiştirici KOYMAK GEREKMEZ — referans tasarımı bozulmadan ikinci dil kanıtlanır. ISO 639-1 iki harfli kod ('tr', 'en'); bölgeli kod ('tr-TR') indirgenir ve indirgeme yanıtta bildirilir. Kod projenin languages listesinde yoksa çağrı REDDEDİLİR: runtime tanımadığı kodu yok sayıp kareyi varsayılan dilde çizerdi ve 'çevrildi' sanılan yanlış bir kare raporlanırdı. MOBİL uygulamada da geçerlidir (/preview aynı ?lang'i okur); cihazın kendisinde ?lang yoktur (platform_guide('mobile') §Çok dil)."),
             colorScheme: z.enum(['light', 'dark']).optional().describe("Kareyi açık ya da koyu temada çeker. Ziyaretçi tema tercihi çerezde değil localStorage'da yaşar ve tema store'u onu sayfa açılırken bir kez okur; gateway tercihi sayfa script'lerinden ÖNCE eker, bu yüzden sayfada 'theme-toggle' komponenti OLMASA DA koyu tema karesi alınabilir. Verilmezse projenin kendi modu çizilir."),
             motion: z.enum(['frozen', 'play']).optional().describe("Varsayılan 'frozen': bağlam 'hareketi azalt' (prefers-reduced-motion: reduce) ile açılır; mobil runtime hareketi dondurur ve kare tekrarlanabilir olur — diff'in imageUnchanged'ı ancak böyle anlamlıdır. Web sayfasında yalnız bu tercihe uyan CSS animasyonları durur. 'play': hareket oynar (giriş animasyonu, dönen gösterge, iskelet parıltısı); kare çekildiği ana bağlıdır, iki kare bayt bayt aynı çıkmayabilir ve yanıt bunu motionNote ile söyler. diff belleği iki kipi ayrı tutar."),
@@ -337,6 +339,20 @@ export function registerPageTools(server, platform, injectedScreenshotter, injec
             if (incompleteDrag >= 0) {
                 throw new PlatformApiError(`page_screenshot: actions[${incompleteDrag}] 'drag' adımı hem target (sürüklenen öğe) hem to (bırakma hedefi) ister — ör. {action:'drag', target:'kb_board__card-42', to:'kb_board__col-Assigned'}.`);
             }
+            const misplacedOffset = actions?.findIndex(step => step.action !== 'swipe' && (step.dx !== undefined || step.dy !== undefined)) ?? -1;
+            if (misplacedOffset >= 0) {
+                throw new PlatformApiError(`page_screenshot: actions[${misplacedOffset}] '${actions?.[misplacedOffset]?.action}' adımı dx/dy almaz — kayma yalnız 'swipe' jestinindir.`);
+            }
+            const swipeIndex = actions?.findIndex(step => step.action === 'swipe' && (step.target === undefined || (step.to === undefined) === (step.dx === undefined && step.dy === undefined))) ?? -1;
+            if (swipeIndex >= 0) {
+                throw new PlatformApiError(actions?.[swipeIndex]?.target === undefined
+                    ? `page_screenshot: actions[${swipeIndex}] 'swipe' adımı target (jestin basıldığı öğe) ister — ör. {action:'swipe', target:'lst__row-2__handle', to:'lst__row-0'}.`
+                    : `page_screenshot: actions[${swipeIndex}] 'swipe' adımı ya to ya dx/dy ister (bitiş öğesi ya da göreli kayma), ikisini birden ya da hiçbirini değil — ör. {action:'swipe', target:'lst__row-1', dx:-160, dy:0}.`);
+            }
+            const stillSwipe = actions?.findIndex(step => step.action === 'swipe' && step.to === undefined && (step.dx ?? 0) === 0 && (step.dy ?? 0) === 0) ?? -1;
+            if (stillSwipe >= 0) {
+                throw new PlatformApiError(`page_screenshot: actions[${stillSwipe}] 'swipe' adımının kayması sıfır — yerinde jest bir basıştır; dokunuş için {action:'click', target:'${actions?.[stillSwipe]?.target}'} kullanın.`);
+            }
             if (!config.studioBaseUrl) {
                 throw new PlatformApiError("page_screenshot için STUDIO_BASE_URL tanımlı değil. Studio arayüzünün kök adresini .env'e ekleyin (yerel geliştirmede http://localhost:3000, dağıtımda nginx adresi).");
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appaflytech/zeyrek-ai-mcp",
-  "version": "0.0.49",
+  "version": "0.0.50",
   "type": "module",
   "description": "Zeyrek (NgApps) platform APIs as MCP tools — data, logic and Studio design surface in one gateway",
   "license": "UNLICENSED",