@appaflytech/zeyrek-ai-mcp 0.0.52 → 0.0.53

package/dist/platform/capture/capture.js

@@ -6,7 +6,7 @@ import { PersistentScreenshotBrowser, persistentContextOpener, screenshotProfile
 import { actionScript, activeTabScript, rootElementId, runtimePropsScript } from './actions.js';
 import { domSummaryScript } from './summary.js';
 import { createPageConsoleLog, describePageFailure, isExpressionEcho, parseRenderErrors, renderErrorsScript, splitExpressionErrors } from './console-log.js';
-import { decideReadiness, describeUnready, parseReadiness, readinessScript, runtimePath } from './readiness.js';
+import { awaitingUserNote, decideReadiness, describeUnready, parseAwaitingWindow, parseReadiness, readinessScript, runtimePath } from './readiness.js';
 /** Runtime'ın Connect Data bağlantısı için bastığı sözde akış kimliği: hata bir akış adımından değil bağlı prop'un okumasından gelir. */
 const CONNECT_DATA_FLOW_ID = 'connect-data';
 /**
@@ -159,6 +159,9 @@ const resizeSettleBudgetMs = 3000;
  * çağrıya ve ~3.5 dakikaya mal oldu). İkiden fazlası turu uzatır, bir şey kazandırmaz.
  */
 const navigationAttempts = 2;
+/** g-12 oturumları: depo durumu çerez (jeton dahil) taşıdığı için diske değil süreç belleğine yazılır. */
+const sessionTtlMs = 30 * 60_000;
+const maxSessions = 8;
 /**
  * Yalnız zaman aşımı yeniden denenir. `net::ERR_CONNECTION_REFUSED` / DNS gibi hızlı düşen
  * hatalarda Studio ayakta değildir; tekrar yalnız bekleme süresini iki katına çıkarır ve
@@ -232,6 +235,7 @@ export class StudioScreenshotter {
     queue = Promise.resolve();
     pending = 0;
     recycleNext = false;
+    sessions = new Map();
     constructor(config, launcher) {
         this.config = config;
         this.launcher = launcher;
@@ -307,7 +311,7 @@ export class StudioScreenshotter {
      * işaretlenir ve kare yine çekilir, çünkü bozuk/boş sayfayı görmek de bir doğrulamadır. Veri
      * yanıtından sonra fontlar + kısa yerleşme beklemesi Svelte hydrate'ine alan bırakır.
      */
-    async runActions(page, request, consoleLog) {
+    async runActions(page, context, request, consoleLog) {
         if (!request.actions || request.actions.length === 0)
             return undefined;
         const outcomes = [];
@@ -319,12 +323,23 @@ export class StudioScreenshotter {
             }
             const snapshotBefore = parseReadiness(await page.evaluate(readinessScript).catch(() => undefined));
             const activityBefore = snapshotBefore?.activity ?? null;
-            const raw = await page.evaluate(actionScript(action, request.target)).catch(error => ({
-                found: false,
-                applied: false,
-                note: error instanceof Error ? error.message : String(error),
-                requests: 0
-            }));
+            // `network` (g-12) sayfada betik koşturmaz: bağlamın ağını değiştirir ve sayfanın gördüğü `navigator.onLine`'ı
+            // okur. Ağ açılınca koşan eşitleme akışları aşağıdaki aynı hazırlık beklemesiyle `flowRuns`'a yazılır.
+            const raw = action.action === 'network'
+                ? context.setOffline === undefined
+                    ? { found: true, applied: false, note: 'ağ denetimi yok: tarayıcı bağlamı setOffline desteklemiyor — ağ DEĞİŞMEDİ', requests: 0 }
+                    : await (async () => {
+                        const count = await page.evaluate("performance.getEntriesByType('resource').length").catch(() => 0);
+                        await context.setOffline?.(action.value === 'offline');
+                        const online = await page.evaluate('navigator.onLine').catch(() => undefined);
+                        return { found: true, applied: true, requests: typeof count === 'number' ? count : 0, ...(typeof online === 'boolean' ? { online } : {}) };
+                    })()
+                : await page.evaluate(actionScript(action, request.target)).catch(error => ({
+                    found: false,
+                    applied: false,
+                    note: error instanceof Error ? error.message : String(error),
+                    requests: 0
+                }));
             const before = (raw ?? {});
             // Hedef bulunamadıysa ajan neyi yanlış yazdığını KAREDEN çıkaramaz. `__` taşıyan hedef bir
             // iç rol denemesidir: bilinen roller sayılır. Kök hedefi bulunamadıysa sorun elementId'nin
@@ -335,6 +350,9 @@ export class StudioScreenshotter {
                     : action.target.includes(INTERNAL_ROLE_SEPARATOR)
                         ? `'${action.target}' sayfada yok. Bu bir İÇ ROL hedefi: biçim <elementId>__<rol> ve bilinen roller — ${knownInternalRoles().join(' · ')}. Roller görünen metinden değil kayıttaki anahtardan türer (sekme key'i, kart id'si); hedef bileşenin rollerini component_get çıktısındaki internalRoles verir.`
                         : `'${action.target}' elementId'si sayfada yok. page_schema_get ile elementId'leri listeleyin; bir komponentin İÇ kontrolünü hedefliyorsanız <elementId>__<rol> biçimini kullanın (component_get çıktısındaki internalRoles).`;
+                const openWindow = parseAwaitingWindow(before.openWindow);
+                if (openWindow !== null)
+                    before.note = `${before.note} Açık önizleme penceresi: ${openWindow.id}${openWindow.kind === null ? '' : ` (${openWindow.kind})`}; sayfanın düğmeleri onun altında kalır.`;
             }
             // Olay akışı uç çağırıyor: yerleşme beklemeden sonraki istek sayısını ölçmek "istek gitti mi"
             // sorusunu cevaplar — koşuda kusuru kesinleştiren gözlem buydu.
@@ -376,9 +394,11 @@ export class StudioScreenshotter {
                 : undefined;
             const propWritten = typeof propsAfter === 'string' ? propsAfter !== before.propsBefore : undefined;
             const applied = before.applied === true && propWritten !== false;
+            // g-11: eylem bir önizleme penceresi açtıysa (onay, uyarı, biyometri) sıradaki eylemin neye basacağı burada söylenir.
+            const awaitingNote = readiness.state === 'awaiting-user' ? awaitingUserNote(readiness.snapshot?.awaitingWindow) : undefined;
             const note = propWritten === false
                 ? `değer DOM'a yazıldı ama '${rootElementId(String(action.target ?? ''))}' düğümünün runtime prop'ları DEĞİŞMEDİ — bileşen olayı kendi change yoluna çevirmedi ya da değer zaten aynıydı. Çok alanlı bileşende <elementId>__<rol> kutusunu hedefleyin (component_get → internalRoles).`
-                : before.note;
+                : [before.note, awaitingNote].filter((part) => part !== undefined && part !== '').join(' ') || undefined;
             outcomes.push({
                 index,
                 action: String(action.action),
@@ -395,6 +415,7 @@ export class StudioScreenshotter {
                 ...(before.optionsSeen === undefined ? {} : { optionsSeen: before.optionsSeen }),
                 ...(before.waitedMs === undefined ? {} : { waitedMs: before.waitedMs }),
                 ...(before.submitVia === undefined ? {} : { submitVia: before.submitVia }),
+                ...(before.online === undefined ? {} : { online: before.online }),
                 pageState: readiness.state
             });
         }
@@ -491,7 +512,47 @@ export class StudioScreenshotter {
             context = await browser.newContext(contextOptions);
         }
         logStep('tarayıcı →', `GET ${request.url} · viewport ${request.viewport.width}x${request.viewport.height}${request.fullPage ? ' · fullPage' : ''}${request.token ? '' : ' · gateway jetonu YOK'}${(request.cookies ?? []).length > 0 ? ` · caller çerezleri: ${(request.cookies ?? []).map(cookie => cookie.name).join(', ')}` : ''}${request.token || (request.cookies ?? []).length > 0 ? '' : ' · ANONİM (çerez YOK)'}${request.colorScheme ? ` · tema ${request.colorScheme}` : ''}${request.motion === 'play' ? ' · hareket oynar' : ''}${request.headers ? ` · başlık: ${Object.keys(request.headers).join(', ')}` : ''}`);
+        let sessionRestored;
+        // Oturum depoyu bir kez kaydeder: başarılı yolda yanıttan önce, hata yolunda `finally`'de. Yükleme yarıda kaldıysa
+        // (`setStorageState` önce siler, sonra yazar) yarı boş depo iyi kaydın üstüne yazılmaz (g-12 inceleme #6).
+        let sessionPending = request.session !== undefined;
+        // Okunamayan depo eski kaydı BIRAKMAZ: bırakılsaydı sonraki çekim aradaki yazmaları sessizce kaybeden eski depoyu
+        // `sessionRestored: true` ile yüklerdi (g-12 inceleme #5).
+        const saveSession = async () => {
+            sessionPending = false;
+            if (request.session === undefined || !context.storageState)
+                return true;
+            const state = await context.storageState().catch(() => undefined);
+            this.sessions.delete(request.session);
+            if (state === undefined)
+                return false;
+            this.sessions.set(request.session, { state, at: Date.now() });
+            for (const [key, entry] of this.sessions) {
+                if (Date.now() - entry.at > sessionTtlMs || this.sessions.size > maxSessions)
+                    this.sessions.delete(key);
+            }
+            return true;
+        };
         try {
+            // Oturum çerezlerden ÖNCE yüklenir: `setStorageState` mevcut depoyu siler, sonra yazılan jeton çerezi kalsın.
+            // Yeteneği olmayan bağlamda çağrı sessizce taze depoyla çekilmez (colorScheme'in kuralı).
+            if (request.session !== undefined) {
+                if (!context.storageState || !context.setStorageState) {
+                    throw new PlatformApiError(`session='${request.session.split('|')[0]}' uygulanamadı: tarayıcı bağlamı depo durumunu okuyup yükleyemiyor (storageState/setStorageState). Kare taze depoyla çekilirdi ve bu sessizce yanlış olurdu.`);
+                }
+                const saved = this.sessions.get(request.session);
+                if (saved !== undefined && Date.now() - saved.at > sessionTtlMs)
+                    this.sessions.delete(request.session);
+                sessionRestored = saved !== undefined && Date.now() - saved.at <= sessionTtlMs;
+                // İlk çağrı da boş depoyla başlar: kalıcı profilde önceki çekimlerden kalan köken anlık görüntüye girmesin (#8).
+                try {
+                    await context.setStorageState(sessionRestored && saved !== undefined ? saved.state : { cookies: [], origins: [] });
+                }
+                catch (error) {
+                    sessionPending = false;
+                    throw error;
+                }
+            }
             const cookies = new Map();
             if (request.token)
                 cookies.set('NG_AccessToken', request.token);
@@ -573,7 +634,7 @@ export class StudioScreenshotter {
                 : readiness.state === 'not-ready' ? false : undefined;
             const finalHref = readiness.snapshot?.href;
             const finalUrl = finalHref !== undefined && runtimePath(finalHref) !== runtimePath(request.url) ? finalHref : undefined;
-            const actions = await this.runActions(page, request, consoleLog);
+            const actions = await this.runActions(page, context, request, consoleLog);
             // Ölçüm EYLEMLERDEN SONRA: eylem sekme değiştirir, filtre uygular, panel açar — içerik
             // boyu o zaman kesinleşir. Eskiden ölçüm eylemlerden önceydi ve ikinci sekmede 40 satırlık
             // tablo açan bir çekim viewport boyunda kalıyordu; `contentHeight` ilk sekmenin boyuydu
@@ -643,6 +704,7 @@ export class StudioScreenshotter {
             if (runtimeErrors.length > 0) {
                 logStep('akış hatası ✕', `${runtimeErrors.length} akış adımı hata bıraktı — sayfa yine 200 döndü`, runtimeErrors.map(error => `${error.step?.name ?? '?'}${error.element ? ` → ${error.element}.${error.property ?? '?'}` : ''}: ${error.message ?? ''}`));
             }
+            const sessionSaved = await saveSession();
             return {
                 ...(png === undefined ? {} : { png, mimeType: format === 'jpeg' ? 'image/jpeg' : 'image/png' }),
                 ...(png === undefined ? {} : (size => size === undefined ? {} : { imageSize: size })(imageSize(png))),
@@ -653,6 +715,7 @@ export class StudioScreenshotter {
                 renderWaitTimedOut: apiStatus === undefined,
                 elapsedMs,
                 pageState: readiness.state,
+                ...(readiness.state === 'awaiting-user' && readiness.snapshot?.awaitingWindow ? { awaitingWindow: readiness.snapshot.awaitingWindow } : {}),
                 readyAfterMs: readiness.waitedMs,
                 ...(finalUrl === undefined ? {} : { finalUrl }),
                 ...(measured === undefined ? {} : { contentHeight: measured }),
@@ -665,10 +728,16 @@ export class StudioScreenshotter {
                 ...(pageErrors.length > 0 ? { pageErrors } : {}),
                 ...(renderErrors.length > 0 ? { renderErrors } : {}),
                 ...(flowsSettled === undefined ? {} : { flowsSettled }),
-                ...(navigationRetried ? { navigationRetried: true } : {})
+                ...(navigationRetried ? { navigationRetried: true } : {}),
+                ...(sessionRestored === undefined ? {} : { sessionRestored }),
+                ...(sessionSaved ? {} : { sessionSaved: false })
             };
         }
         finally {
+            // Hata yolunda da depo kapanıştan ÖNCE alınır (kalıcı profil kapanışta depoyu siler): ağsız yazılmış kayıt
+            // çekim düşse de oturumda kalır. En yenisi sona yazılır; süresi dolan ve sekizi aşan en eski oturum düşer.
+            if (sessionPending)
+                await saveSession();
             await context.close().catch(() => undefined);
             // Zamanlayıcı ÖNCE temizlenir: eskiden her çekim yenisini kurup eskisini bırakıyordu ve
             // kaçan zamanlayıcı sonraki çekimin ortasında tarayıcıyı kapatıyordu (S-3).

package/dist/platform/capture/persistent-browser.js

@@ -72,6 +72,8 @@ export class PersistentScreenshotBrowser {
  * Tek çekimlik oturum. Eski taze bağlamın yalıtımı korunur: başlık ve init script'i bağlama
  * değil sayfaya yazılır (sonraki çekime sızmaz — `impersonated-user-id` dahil), kapanışta
  * çerezler ve gezilen kökenlerin depoları (localStorage, IndexedDB, …) diskteki profilden silinir.
+ * `session` (g-12) bu silmeyi atlamaz: depo kapanıştan önce okunur, sonraki çekimde yüklenir; yüklenen kökenler de
+ * kapanışta silinir. Ağ kesildiyse sayfalar kapandıktan SONRA geri açılır — bağlam sonraki çekimle paylaşılır.
  */
 class PersistentContextSession {
     context;
@@ -79,6 +81,8 @@ class PersistentContextSession {
     initScripts = [];
     headers;
     pages = [];
+    restoredOrigins = new Set();
+    offline = false;
     constructor(context, options) {
         this.context = context;
         this.options = options;
@@ -92,6 +96,20 @@ class PersistentContextSession {
     async setExtraHTTPHeaders(headers) {
         this.headers = headers;
     }
+    async setOffline(offline) {
+        await this.context.setOffline(offline);
+        this.offline = offline;
+    }
+    storageState() {
+        return this.context.storageState({ indexedDB: true });
+    }
+    async setStorageState(state) {
+        for (const entry of state.origins ?? []) {
+            if (typeof entry.origin === 'string')
+                this.restoredOrigins.add(entry.origin);
+        }
+        await this.context.setStorageState(state);
+    }
     async newPage() {
         const page = await this.context.newPage();
         this.pages.push(page);
@@ -104,7 +122,7 @@ class PersistentContextSession {
         return page;
     }
     async close() {
-        const origins = new Set();
+        const origins = new Set(this.restoredOrigins);
         for (const page of this.pages) {
             try {
                 const origin = new URL(page.url()).origin;
@@ -126,5 +144,9 @@ class PersistentContextSession {
         await this.context.clearCookies().catch(() => undefined);
         for (const page of this.pages)
             await page.close().catch(() => undefined);
+        // Ağ EN SON açılır: sayfa açıkken açılsaydı çevrimdışı uygulama `online` olayıyla kuyruğunu sunucuya boşaltırdı —
+        // salt okunur bir çekimden görünmez yazma, oturumla taşınan kuyrukta da çift kayıt (g-12 inceleme #4).
+        if (this.offline)
+            await this.context.setOffline(false).catch(() => undefined);
     }
 }

package/dist/platform/capture/readiness.js

@@ -14,6 +14,13 @@
  * (`captureUnready: true` teşhis kipi dışında). Bozuk sayfayı görmek istiyorsan hata mesajı
  * neyin görüldüğünü zaten söyler.
  */
+/**
+ * Önizlemenin kendi pencereleri — uygulama düğümü değil, Studio kabuğunun öğesi. Açıkken bir akış adımı kullanıcının
+ * yanıtını bekler: `biometric-auth` (kök ADR 0021, `@ng-apps/ui-native` `preview-biometric.tsx`) ve `confirm`/`alert`
+ * (Studio `components/dialog`, plans/defter-saha-bulgulari f-11; tür `data-dialog-kind`'da).
+ * Seçici yalnız çift tırnak taşır: betiklere tek tırnakla gömülür.
+ */
+export const AWAITING_WINDOW_SELECTOR = '[data-element-id="preview-biometric"], [data-element-id="preview-dialog"]';
 export const readinessScript = `(function () { /* readinessSnapshot */
   var activity = window.__ngAppsFlowActivity;
   return {
@@ -22,11 +29,34 @@ export const readinessScript = `(function () { /* readinessSnapshot */
     skeleton: !!document.querySelector('.view-detail > .bx--skeleton__placeholder'),
     viewDetail: !!document.querySelector('.view-detail'),
     errorState: !!document.querySelector('.view-detail__error, .view-detail .error-page'),
-    awaitingUser: !!document.querySelector('[data-element-id="preview-biometric"]'),
+    awaitingUser: !!document.querySelector('${AWAITING_WINDOW_SELECTOR}'),
+    awaitingWindow: (function () {
+      var open = document.querySelector('${AWAITING_WINDOW_SELECTOR}');
+      return open ? { id: String(open.getAttribute('data-element-id')), kind: open.getAttribute('data-dialog-kind') } : null;
+    })(),
     readyState: String(document.readyState),
     href: String(location.href)
   };
 })()`;
+/** Tarayıcıdan gelen pencere değeri; kimliği olmayan değer pencere sayılmaz. */
+export function parseAwaitingWindow(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const { id, kind } = raw;
+    return typeof id === 'string' && id !== '' ? { id, kind: typeof kind === 'string' ? kind : null } : null;
+}
+/**
+ * `awaiting-user` karesinin ve pencere açıkken bulunamayan `click` hedefinin notu: hangi pencere açık, dalı sürmek için hangi
+ * düğmeye basılır. Kimlikler çevrilmiş metinden bağımsızdır; production'da (cihaz, `/view`) bu pencereler yoktur.
+ */
+export function awaitingUserNote(window) {
+    if (window?.id === 'preview-dialog') {
+        return window.kind === 'alert'
+            ? "Bir akış kullanıcı penceresini bekliyor: önizlemenin uyarı penceresi (alert adımı) açık. Kare pencereyi gösterir; kapatıp akışı sürdürmek için sonraki eylem { action: 'click', target: 'preview-dialog__confirm' }. Kimlik yalnız Studio önizlemesindedir; cihazda pencere işletim sisteminindir."
+            : "Bir akış kullanıcı penceresini bekliyor: önizlemenin onay penceresi (confirm adımı) açık. Kare pencereyi gösterir; onay dalı için sonraki eylem { action: 'click', target: 'preview-dialog__confirm' }, red dalı için 'preview-dialog__cancel'. Kimlikler yalnız Studio önizlemesindedir; cihazda pencere işletim sisteminindir.";
+    }
+    return "Bir akış kullanıcı penceresini bekliyor: önizlemenin biyometri penceresi açık (kök ADR 0021). Kare pencereyi gösterir; dalı sürmek için sonraki eylem { action: 'click', target: 'preview-biometric__verify' } (Doğrulandı say) ya da 'preview-biometric__cancel' (vazgeç). Production /view'da pencere yoktur.";
+}
 /** Okunan değer gerçekten sayaç mı; değilse sayfa sayaç yayınlamıyordur (eski runtime). */
 export function isFlowActivity(activity) {
     if (!activity || typeof activity !== 'object')
@@ -48,6 +78,7 @@ export function parseReadiness(raw) {
         viewDetail: value.viewDetail === true,
         errorState: value.errorState === true,
         awaitingUser: value.awaitingUser === true,
+        awaitingWindow: parseAwaitingWindow(value.awaitingWindow),
         readyState: String(value.readyState ?? ''),
         href: value.href
     };

package/dist/platform/errors.js

@@ -12,6 +12,12 @@ export class PlatformApiError extends Error {
      * izin slug'ları geçer ('entity.reveal grant'i'); `accessDecision` izni ondan okursa yanlış izin yazar.
      */
     apiMessage;
+    /**
+     * Ağ hatası geçici: ad çözümleme ya da yanıt öncesi bağlantı kopması (D-19). Ajan tekrar edilebilirliği metni
+     * ayrıştırmadan bilsin diye araç hata yanıtına `transient: true` olarak çıkar. Zaman aşımı geçici SAYILMAZ:
+     * uzun işlemi tekrar etmek aynı süreyi bir kez daha bekletir.
+     */
+    transient;
     constructor(message, status, code) {
         super(message);
         this.status = status;
@@ -474,17 +480,51 @@ export function mapPlatformError(status, payload, context) {
 }
 const CONNECTION_RESET_CODES = new Set(['ECONNRESET', 'UND_ERR_SOCKET', 'EPIPE', 'ECONNABORTED']);
 /**
- * Bağlantı yolda koptu mu (yanıt gelmeden): Docker Desktop'ın host port yönlendirmesi yük altında açık bağlantıları ara ara
- * düşürür — konteyner içinden aynı uç kopmaz (f-02, 2026-10-24 ölçümü: içeride 0/1800, host'ta `:3000` 4/1800, `:80` 2/1800).
+ * Ad çözümlemesi bağlantı açılmadan düşer; istek sunucuya hiç gitmemiştir. Defter uzun betiklerin ortasında `ENOTFOUND`
+ * gördü ve kendi istemcisine üç denemelik sarmal yazdı (D-19).
  */
-export function isConnectionReset(error) {
+const NAME_RESOLUTION_CODES = new Set(['ENOTFOUND', 'EAI_AGAIN']);
+function transientNetworkKind(error) {
     const failure = error;
-    return CONNECTION_RESET_CODES.has(String(failure?.code)) || CONNECTION_RESET_CODES.has(String(failure?.cause?.code));
+    const codes = [String(failure?.code), String(failure?.cause?.code)];
+    if (codes.some(code => NAME_RESOLUTION_CODES.has(code)))
+        return 'name-resolution';
+    if (codes.some(code => CONNECTION_RESET_CODES.has(code)))
+        return 'connection-reset';
+    return undefined;
+}
+/**
+ * Tekrarı zararsız istekte (GET/HEAD, kimlik jetonu) geçici ağ hatasından sonraki beklemeler; uzunluğu tekrar sayısıdır
+ * (D-19: en çok iki tekrar). Zaman aşımı bu yola girmez — varsayılan istek süresi 100 sn, tekrar onu bir kez daha bekletirdi.
+ */
+export const NETWORK_RETRY_DELAYS_MS = [250, 1000];
+/**
+ * Yanıt gelmeden düşen ve kısa beklemeyle geçebilen ağ hatası: ad çözümleme (`ENOTFOUND`/`EAI_AGAIN`) ya da yolda kopan
+ * bağlantı. Docker Desktop'ın host port yönlendirmesi yük altında açık bağlantıları ara ara düşürür — konteyner içinden
+ * aynı uç kopmaz (f-02, 2026-10-24 ölçümü: içeride 0/1800, host'ta `:3000` 4/1800, `:80` 2/1800). `undici` kodu kimi
+ * zaman `cause.code`'da taşır.
+ */
+export function isTransientNetworkError(error) {
+    return transientNetworkKind(error) !== undefined;
 }
-export function mapNetworkError(error, context) {
+export function mapNetworkError(error, context, attempt = { attempts: 1, readOnly: context.method === 'GET' || context.method === 'HEAD' }) {
     const cause = error instanceof Error ? error : new Error(String(error));
     if (cause.name === 'TimeoutError' || cause.name === 'AbortError') {
         return new PlatformApiError(`${context.api} API zaman aşımına uğradı (${context.method} ${context.path}). Uzun süren bir işlemse durumu ilgili *_history/*_status tool'undan izleyin.`);
     }
+    const kind = transientNetworkKind(error);
+    const tried = attempt.attempts > 1 ? ` (${attempt.attempts} deneme)` : '';
+    if (kind === 'name-resolution') {
+        const failure = new PlatformApiError(`${context.api} API'nin adı çözülemedi (${context.baseUrl})${tried}: ${cause.message}. İstek sunucuya ULAŞMADI (ad çözülemedi) — aynı çağrıyı tekrarlamak güvenli. Sürüyorsa DNS/ağ bağlantısını kontrol edin.`);
+        failure.transient = true;
+        return failure;
+    }
+    if (kind === 'connection-reset') {
+        const failure = new PlatformApiError(attempt.readOnly
+            ? `${context.api} API bağlantısı yanıt gelmeden koptu (${context.method} ${context.path})${tried}: ${cause.message}. Okuma isteği — tekrarlamak güvenli.`
+            : `${context.api} API bağlantısı yanıt gelmeden koptu (${context.method} ${context.path}): ${cause.message}. İstek sunucuya ulaşmış olabilir — tekrarlamadan önce yazının gerçekleşip gerçekleşmediğini ilgili *_get/*_list tool'uyla doğrulayın; yeniden yazmak çift kayıt üretebilir.`);
+        failure.transient = true;
+        return failure;
+    }
     return new PlatformApiError(`${context.api} API'ye ulaşılamadı (${context.baseUrl}): ${cause.message}. API ayakta mı? Lokal ortam için docker compose ya da dotnet run kontrol edin.`);
 }

package/dist/platform/http.js

@@ -1,4 +1,4 @@
-import { PlatformApiError, isConnectionReset, mapNetworkError, mapPlatformError } from './errors.js';
+import { NETWORK_RETRY_DELAYS_MS, PlatformApiError, isTransientNetworkError, mapNetworkError, mapPlatformError } from './errors.js';
 import { logStep, logsDetail, renderJson } from '../observability/trace.js';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { TokenProvider } from './token.js';
@@ -30,6 +30,9 @@ export function responseHeadersForTool(raw) {
         .map(([name, value]) => [name.toLowerCase(), Array.isArray(value) ? value.join(', ') : value])
         .filter((entry) => typeof entry[1] === 'string' && !hiddenResponseHeaders.has(entry[0])));
 }
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
 function buildMultipart(parts, boundary) {
     const chunks = [];
     for (const part of parts) {
@@ -74,10 +77,12 @@ function appendQuery(url, query) {
 }
 export class Platform {
     config;
+    wait;
     tokens;
-    constructor(config, tokens) {
+    constructor(config, tokens, wait = sleep) {
         this.config = config;
-        this.tokens = tokens ?? new TokenProvider(config);
+        this.wait = wait;
+        this.tokens = tokens ?? new TokenProvider(config, wait);
     }
     resolveProject(project) {
         const resolved = project ?? this.config.defaultProject;
@@ -134,7 +139,7 @@ export class Platform {
         }
         return `Bearer ${await this.tokens.getToken()}`;
     }
-    async send(api, method, path, options, raw = false, isRetry = false, networkRetried = false) {
+    async send(api, method, path, options, raw = false, isRetry = false, networkAttempt = 1) {
         const baseUrl = api === 'org' ? this.config.orgApiBaseUrl : this.config.tenantApiBaseUrl;
         const context = { api, method, path, baseUrl, environment: options.environment, authMode: this.config.authMode };
         const url = new URL(`${baseUrl}${path}`);
@@ -207,12 +212,15 @@ export class Platform {
         }
         catch (error) {
             logStep('ağ ✕', `${method} ${url.href} · ${Date.now() - startedAt} ms sonra ulaşılamadı`, [error instanceof Error ? `${error.name}: ${error.message}` : String(error)]);
-            // Yalnız tekrarı zararsız istek (GET/HEAD) ve yalnız bir kez: yazan istek sunucuya ulaşmış olabilir.
-            if ((method === 'GET' || method === 'HEAD') && !networkRetried && !options.noNetworkRetry && isConnectionReset(error)) {
-                logStep('ağ ⟳', `${method} ${url.href} · bağlantı koptu, bir kez yeniden deneniyor`);
-                return this.send(api, method, path, options, raw, isRetry, true);
+            // Yalnız tekrarı zararsız istek (GET/HEAD): yazan istek sunucuya ulaşmış olabilir ve kimliksiz yazma çift kayıt üretir (D-19).
+            const readOnly = (method === 'GET' || method === 'HEAD') && !options.noNetworkRetry;
+            const delay = NETWORK_RETRY_DELAYS_MS[networkAttempt - 1];
+            if (readOnly && delay !== undefined && isTransientNetworkError(error)) {
+                logStep('ağ ⟳', `${method} ${url.href} · geçici ağ hatası, ${delay} ms sonra yeniden deneniyor (deneme ${networkAttempt + 1}/${NETWORK_RETRY_DELAYS_MS.length + 1})`);
+                await this.wait(delay);
+                return this.send(api, method, path, options, raw, isRetry, networkAttempt + 1);
             }
-            throw mapNetworkError(error, context);
+            throw mapNetworkError(error, context, { attempts: networkAttempt, readOnly });
         }
         logStep('yanıt ←', `HTTP ${statusCode} · ${Date.now() - startedAt} ms · ${responseBytes} B`, statusCode >= 400 || logsDetail()
             ? [`gövde: ${options.expectBinary && statusCode < 400 ? `<ikili içerik · ${responseBytes} B>` : renderJson(payload)}`]

package/dist/platform/responses.js

@@ -211,9 +211,15 @@ export function toolError(error, expectFailure) {
     // Kasıtlı negatif testte (bayat version 409, yetkisiz kişi 403) platform hatası da bir KANITTIR:
     // ölçüm aracı bu satırı plansız hata saymasın diye işaret taşınır.
     const isExpectedPlatformError = expectFailure === true && (error instanceof PlatformApiError || error instanceof PolicyBlockError);
+    // Ajan tekrar edilebilir ağ hatasını metni ayrıştırmadan bilsin (D-19); yazan istekte metin tekrarın güvenli olup olmadığını söyler.
+    const isTransient = error instanceof PlatformApiError && error.transient === true;
+    const structuredContent = {
+        ...(isExpectedPlatformError ? { expectedFailure: true } : {}),
+        ...(isTransient ? { transient: true } : {})
+    };
     return {
         content: [{ type: 'text', text: message }],
-        ...(isExpectedPlatformError ? { structuredContent: { expectedFailure: true } } : {}),
+        ...(Object.keys(structuredContent).length > 0 ? { structuredContent } : {}),
         isError: true
     };
 }

package/dist/platform/secrets.js

@@ -27,6 +27,12 @@ const maxDepth = 12;
  * `StepCustomParameterDto {name,value,order}`, `QueryParameter {name,type,value}`: değer bağlama
  * ifadesidir (`input.token`), maskelenirse get → update turunda `***` geri yazılır (GW-001).
  * `expression` + `value` hiçbir paketli şemada geçmez, o yüzden bu ayrımın dışındadır.
+ *
+ * `expiresInHours` taşıyan ve değeri bir ifade olan satır da tanımdır (g-17): `setcookie` adımının `args`'ı
+ * `{ name: 'APP_Token', value: 'Steps.sign_in.data.token', expiresInHours }` — maskelenince flow_get → flow_update
+ * turu çereze `***` yazıp girişi bozuyordu. Değer tırnakla başlıyorsa dizgi sabitidir ve maskelenir: yürütme yanıtının
+ * `uiActions`'ı aynı şekli GERÇEK değerle taşır (`SetCookieStep.cs`: `value: "\"<değer>\""`), tanımdaki sabit de
+ * gömülü bir sırdır. `path` muafiyet değildir: `{ name, value, path }` gerçek bir çerezin serileşmiş hâlidir.
  */
 export function secretPairName(record) {
     if (!('value' in record))
@@ -35,6 +41,8 @@ export function secretPairName(record) {
         return record.expression;
     if ('type' in record || 'order' in record)
         return undefined;
+    if ('expiresInHours' in record && typeof record.value === 'string' && !/^\s*["'`]/.test(record.value))
+        return undefined;
     if (typeof record.name === 'string')
         return record.name;
     return typeof record.key === 'string' ? record.key : undefined;

package/dist/platform/token.js

@@ -1,4 +1,4 @@
-import { PlatformApiError, mapNetworkError, mapPlatformError } from './errors.js';
+import { NETWORK_RETRY_DELAYS_MS, PlatformApiError, isTransientNetworkError, mapNetworkError, mapPlatformError } from './errors.js';
 import { logStep } from '../observability/trace.js';
 import { request } from 'undici';
 function readExpiry(token) {
@@ -17,9 +17,11 @@ function readExpiry(token) {
 }
 export class TokenProvider {
     config;
+    wait;
     cached;
-    constructor(config) {
+    constructor(config, wait = ms => new Promise(resolve => setTimeout(resolve, ms))) {
         this.config = config;
+        this.wait = wait;
     }
     async getToken() {
         if (this.config.token)
@@ -40,29 +42,38 @@ export class TokenProvider {
         let statusCode;
         let payload;
         logStep('kimlik →', `önbellekte geçerli token yok — POST ${this.config.orgApiBaseUrl}/connect/token · kullanıcı ${this.config.username ?? '(yok)'}`);
-        try {
-            const response = await request(`${this.config.orgApiBaseUrl}/connect/token`, {
-                method: 'POST',
-                headers: {
-                    host: `${this.config.organization}.${this.config.hostSuffix}`,
-                    'content-type': 'application/x-www-form-urlencoded',
-                    accept: 'application/json'
-                },
-                body: form.toString(),
-                signal: AbortSignal.timeout(this.config.requestTimeoutMs)
-            });
-            statusCode = response.statusCode;
-            const text = await response.body.text();
+        // Jeton isteği kayıt yazmaz: geçici ağ hatasında GET gibi yeniden denenir ve hata tekrarın güvenli olduğunu söyler
+        // (D-19; inceleme: soğuk jeton önbelleğinde tek DNS kesintisi okuyan aracı da düşürüyordu).
+        for (let attempt = 1;; attempt += 1) {
             try {
-                payload = text ? JSON.parse(text) : undefined;
+                const response = await request(`${this.config.orgApiBaseUrl}/connect/token`, {
+                    method: 'POST',
+                    headers: {
+                        host: `${this.config.organization}.${this.config.hostSuffix}`,
+                        'content-type': 'application/x-www-form-urlencoded',
+                        accept: 'application/json'
+                    },
+                    body: form.toString(),
+                    signal: AbortSignal.timeout(this.config.requestTimeoutMs)
+                });
+                statusCode = response.statusCode;
+                const text = await response.body.text();
+                try {
+                    payload = text ? JSON.parse(text) : undefined;
+                }
+                catch {
+                    payload = text;
+                }
+                break;
             }
-            catch {
-                payload = text;
+            catch (error) {
+                const delay = NETWORK_RETRY_DELAYS_MS[attempt - 1];
+                if (delay === undefined || !isTransientNetworkError(error))
+                    throw mapNetworkError(error, context, { attempts: attempt, readOnly: true });
+                logStep('kimlik ⟳', `POST ${this.config.orgApiBaseUrl}/connect/token · geçici ağ hatası, ${delay} ms sonra yeniden deneniyor (deneme ${attempt + 1}/${NETWORK_RETRY_DELAYS_MS.length + 1})`);
+                await this.wait(delay);
             }
         }
-        catch (error) {
-            throw mapNetworkError(error, context);
-        }
         if (statusCode >= 400)
             throw mapPlatformError(statusCode, payload, context);
         const accessToken = payload && typeof payload === 'object' ? payload.access_token : undefined;

package/dist/resources/examples/mobile-offline-list.json

@@ -12,7 +12,7 @@
     "networkError": "Yanıt hiç alınamadıysa (bağlantı yok; saklanan okumalarda 8 sn süre sınırı da) ve kayıt yoksa adım hata dalına gider: Steps.<ad>.error.network true, status 503. 503'ü sunucu da döner — 'bağlantı yok' için network'e bakın (MOB-033 bilgi notu; status == 503 && !network sunucu arızasını ayıran doğru desendir, not almaz). network alanı yalnız veri önbelleği açık uygulamada yazılır. Saklanmayan isteklerde süre sınırı yoktur: yanıt vermeyen sunucuda adım bekler.",
     "stale": "Önbellek son başarılı yanıtı aynen verir: her çağrıda değişen bir GET (sayaç, zaman, rastgele) ağ yokken eski değerini döner. Parametreler ve veri dili isteğin parçasıdır; başka parametreli çağrı başka kayıttır.",
     "detailFromSteps": "Satırlar ve güncelleme satırı SETTER adımıyla yazılır: `{{ Steps.… }}` kod bağı ilk çizimde okunur, Steps'e yazmak düğümü yeniden okutmaz (mobile-list-detail-form ile aynı desen).",
-    "preview": "Önizleme (/dev, Studio, page_screenshot) önbellek KULLANMAZ — ayar açık olsa da her okuma ağdan gider ve cache alanı hiç yazılmaz; güncelleme satırı önizlemede gizli kalır. page_screenshot ağı kesemez: çevrimdışı davranış yalnız cihazda (uçak modu) görülür.",
+    "preview": "Önizleme (/dev, Studio, page_screenshot) önbellek KULLANMAZ — ayar açık olsa da her okuma ağdan gider ve cache alanı hiç yazılmaz; güncelleme satırı önizlemede gizli kalır. page_screenshot network eylemiyle ağı keser (SCR-020) ama önbellek olmadığı için okuma hata yolundan döner; önbellekli davranış yalnız cihazda (uçak modu) görülür.",
     "verify": "page_runtime_get ile sayfa paketi ve akış okunur; page_screenshot({ applicationSlug: '<uygulama>', pageSlug: 'siparisler' }) satırları çizer, txt_guncelleme görünmez."
   },
   "pages": [

package/dist/resources/examples/mobile-offline-queue.json

@@ -12,7 +12,7 @@
     "visibility": "Kaydın sonucu akışa dönmez. Bekleyen ve reddedilen sayısı Device.offline.queue = { pending, rejected }, reddedilenler Device.offline.rejected (id, service, at, status, code, message). Kod adımında Page.offline.list(), Page.offline.count(), Page.offline.sync() ve Page.offline.resolve(id, 'retry' | 'discard').",
     "sync": "Gönderim: bağlantının dönüşü, uygulamanın ön plana dönüşü ve ağla soğuk açılış. Sıra kuyruğa giriş zamanı; tek tek; 4xx kaydı reddeder ve sıra sürer, oturum (401/403), 408, 429, 5xx ve ağ hatası sırayı durdurur.",
     "limits": "Kuyruktaki kayda bağlı ikinci işlem yok: queued yolu Steps.<ad>.data okumaz (dönen kimliği bekleyen adım çevrimdışıyken koşamaz). Dosya parametreli çağrı kuyruğa girmez — adım error'a gider, Steps.<ad>.error.code = 'fileNotQueued'. Kayıt 7 günde gönderilemezse 'expired' ile reddedilir. Kayıtlar kullanıcıya bağlıdır: başkasının bekleyeni gönderilmez, çıkışta silinmez.",
-    "preview": "Studio önizlemesi ve web çalışma zamanında kuyruk yoktur (barındırıcı depo vermez): queued dalı hiç koşmaz. page_screenshot ağı kesemez; davranış yalnız cihazda görülür. Açık ekran ilk çizildiği kopyayla kalır: akışa eklenen queued dalı ekran bir sonraki açılışta etkindir.",
+    "preview": "Studio önizlemesi ve web çalışma zamanında kuyruk yoktur (barındırıcı depo vermez): queued dalı hiç koşmaz. page_screenshot network eylemiyle ağı keser (SCR-020) ama yazma error dalından gider; kuyruklu davranış yalnız cihazda görülür. Açık ekran ilk çizildiği kopyayla kalır: akışa eklenen queued dalı ekran bir sonraki açılışta etkindir.",
     "verify": "microservice_get ile offlineWritable, flow_get ile queued dalı okunur. Cihazda: bağlantıyı kes, dozu işaretle (queued dalı koşar), bağlantıyı aç; row_list'te tek kayıt."
   },
   "microservicePatchArgs": {

package/dist/resources/examples/mobile-offline-seamless.json

@@ -12,8 +12,8 @@
     "list": "Liste = sunucunun yanıtı (ağsızken son okunan) + Page.offline.list()'teki status === 'pending' kayıtlar (service = yazma ucunun slug'ı, parameters'tan alan). Reddedilen kayıt (status 'rejected') listeye katılmaz. Ağ yokluğu hata metni göstermez: tx_liste_hata yalnız Steps.<okuma>.error && !error.network iken görünür.",
     "lock": "Yazan düğme istek süresince isLoading + isDisabled. Kilitsiz düğmede hızlı ikinci dokunuş YENİ bir istek ve yeni bir Idempotency-Key'dir — sunucu ikisini de uygular (ölçüldü: 1,6 sn'de üç dokunuş, üç kayıt). Kilit her dalın sonunda (always, queued, error) açılır.",
     "landing": "Açılış sayfası korumasız giriş ekranıdır; kalıcı state.app.oturumVar (storage: device) true ise mount akışı listeye replace ile geçer. Giriş işareti yazar, çıkış siler. Geçici çare: korumalı açılış sayfası ağsız ilk açılışta çizilemiyor (kök ADR 0024 taslak) ve kabuk bilgisi yokken middleware reddi girişe yönlenmiyor (zeyrek-frontend ARC-342). Mağaza derlemesinde açılış manifestin landingPageSlug'ıdır.",
-    "refresh": "Liste scroll-view refreshable + refresh olayı aynı yükleme akışına bağlı: bağlantı dönünce açık ekranın mount akışı kendiliğinden koşmaz (kök ADR 0025 taslak). Kuyruk gönderilince kayıt artık bekleyen değildir ve önbellekteki eski listede de yoktur — kullanıcı aşağı çekene kadar listeden düşer; ADR 0025 kapanınca kalkar.",
-    "preview": "Studio önizlemesi, /dev ve page_screenshot önbellek ve kuyruk KULLANMAZ: page_screenshot ağı kesemez, ağsız davranış yalnız cihazda (uçak kipi) görülür. Ekran açıkken değişen akış ekran yeniden açılınca etkindir.",
+    "refresh": "Liste scroll-view refreshable + refresh olayı ve sayfanın offlineQueueChange olayı aynı yükleme akışına bağlı (pageUpdateArgs, kök ADR 0029): kuyruğa giren kayıt listeye hemen katılır, bağlantı dönünce gönderilen kayıt kuyruk değiştiği için akış yeniden koşup kaydı sunucudan getirir — listeden düşmez. Bağlantı dönüşünün kendisi açık ekranın mount akışını koşturmaz (kök ADR 0025 taslak); çekerek yenileme yine çalışır.",
+    "preview": "Studio önizlemesi, /dev ve page_screenshot önbellek ve kuyruk KULLANMAZ: page_screenshot network eylemiyle ağı keser (SCR-020) ama okuma da yazma da hata yolundan döner; önbellekli ve kuyruklu davranış yalnız cihazda (uçak kipi) görülür. Ekran açıkken değişen akış ekran yeniden açılınca etkindir.",
     "notWhere": "Kuyruktaki kayda bağlı ikinci işlem (dönen kimlikle yönlendirme) çevrimdışıyken koşamaz; o akışlara queued dalı vermeyin. Giriş ve hiç açılmamış ekran ağ ister — fark yalnız orada görünür."
   },
   "applicationUpdateArgs": {
@@ -1514,7 +1514,16 @@
           "event": "click",
           "eventValue": "<cikis akış id>"
         }
-      ]
+      ],
+      "pageUpdateArgs": {
+        "_note": "Sayfa olayı page_update { events } ile yazılır (mobil sayfa olayı; listeyi kuyruk değişince yeniden kurar).",
+        "events": [
+          {
+            "name": "offlineQueueChange",
+            "value": "<notlar-yukle akış id>"
+          }
+        ]
+      }
     }
   ]
 }

package/dist/resources/guides/deployment.md

@@ -97,6 +97,15 @@ değişimidir: adresin gösterdiği **dosya kopyalanmaz**, production'da adres *
 production'a taşımak için onu dosya tipli prop'a (`ref`) ya da taşınan bir satırın dosya sütununa
 bağlayın.
 
+## Dağıtımdan sonra doğrula
+
+`deployment_status` bitti dedikten sonra `environment_diff({ projectId })` (varsayılan development → production)
+iki ortamın tanım farkını tek çağrıda verir: `equal: true` ise özetlenen modüllerde fark yok. Fark tanım özetinden
+gelir, gövdeyi elle karşılaştırmaya gerek yok. Dağıtım kimlikleri korur; ama development'ta yeniden yazılan bir akış
+(adım parametrelerinin kimlikleri yenilenir) içeriği aynı olsa da `changed` görünebilir.
+`notCovered`'daki modüller (tablolar, bileşenler, erişim, süreçler) ve tablo satırları bu karşılaştırmanın
+dışındadır; satır için §Tablo satırları. `digestNote` varsa özet bayat olabilir.
+
 ## Production'a doğrudan yazılmaz
 
 Eksik satır ya da dosya production'da elle tamamlanamaz. Production ortamında `file_upload`,