@appaflytech/zeyrek-ai-mcp 0.0.51 → 0.0.53

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/flow-credit-spend.json

@@ -0,0 +1,233 @@
+{
+  "_meta": {
+    "synthetic": true,
+    "note": "Mobil kredi harcama ekranı (kök docs/adr/0027-uygulama-ici-satin-alma.md bakiye bölümü, plans/mobil-uygulama-ici-satin-alma g-02): bakiye Balances.kredi'den okunur, düğme balance-spend ile 10 kredi düşer; bakiye yetmezse (insufficient) kullanıcıya söylenir. Akış FLOW-046'dan temiz geçer (test/coverage.test.ts). Kredi satın almak ayrı bir teklif ekranıdır: consumable ürün (kredi_100) purchase adımıyla alınır (flow-purchase-paywall).",
+    "pairsWith": "flow-purchase-paywall (kredi satışı); önce mobile_product_upsert { key: 'kredi_100', kind: 'consumable', balance: 'kredi', grantsAmount: 100, priceTry, texts }",
+    "sourceRef": "platform_guide('mobile-steps') §Kredi harcama tarifi; platform_guide('mobile-publish') §Satın almalar (tüketilen ürün); backend 04-bakiye-defteri.md §Harcama (409 insufficient, çevrimdışı unavailable)"
+  },
+  "_rules": {
+    "order": "Sıra: (1) mobile_product_upsert ile consumable ürün (balance: 'kredi'); (2) page_create + schemaPatchOps (kök önce safe-area); (3) flowCreateArgs; (4) bindOps ile akış kimliğini düğmeye bağla. Bakiye adı katalogdaki consumable ürünün balance alanıdır: katalogda olmayan statik ad FLOW-046 ile yazımda durur.",
+    "args": "balance-spend.value bakiye adı, balance-spend.title MİKTARDIR (args.amount/args.balance sessizce düşer). İkisi de metin şablonudur: düz '10' ya da seçimden '{{ adet.value }}'; {{ }} dışındaki ifade harfi harfine metin sayılır.",
+    "branches": "Adım KAPIDIR: error dalı → hata akışı → ikisi de yoksa akış adımda biter. Steps.<ad>.error.status: insufficient (bakiye yetmiyor, sunucu 409) · unavailable (çevrimdışı ya da sunucuya ulaşılamadı — çevrimdışı kuyruğa girmez) · unsupported (web uygulaması, production /view, eski kabuk) · invalid (ad ya da miktar geçersiz) · failed.",
+    "balance": "Harcamadan sonra Balances kendiliğinden güncellenir; sonucu ayrıca okumayın. Bakiye yalnız sunucudan gelir, istemcide hesaplanmaz.",
+    "signIn": "Girişsiz uygulamada bakiye kuruluma yazılır ve tüketilen ürün mağazada geri yüklenemez: telefon değişince bakiye gider (MOB-036). Girişli uygulamada hesaba taşınır."
+  },
+  "pageCreateArgs": {
+    "name": "Kredi",
+    "slug": "kredi"
+  },
+  "schemaPatchOps": [
+    {
+      "op": "add_component",
+      "parent": "page_container",
+      "component": {
+        "elementId": "guvenli_alan",
+        "name": "guvenli_alan",
+        "type": "safe-area",
+        "kind": "component",
+        "props": {},
+        "appearance": {
+          "marginType": "none",
+          "widthType": "fill"
+        },
+        "blocks": [],
+        "events": [],
+        "validations": [],
+        "stateBindings": [],
+        "children": [
+          {
+            "elementId": "kredi_ekrani",
+            "name": "kredi_ekrani",
+            "type": "container",
+            "kind": "component",
+            "props": {
+              "direction": {
+                "type": "static",
+                "ref": null,
+                "data": "column"
+              },
+              "gap": {
+                "type": "static",
+                "ref": null,
+                "data": "medium"
+              },
+              "horizontalAlign": {
+                "type": "static",
+                "ref": null,
+                "data": "stretch"
+              }
+            },
+            "appearance": {
+              "marginType": "none",
+              "widthType": "fill"
+            },
+            "blocks": [],
+            "events": [],
+            "validations": [],
+            "stateBindings": [],
+            "children": [
+              {
+                "elementId": "txt_kredi_baslik",
+                "name": "txt_kredi_baslik",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Rapor üret"
+                  },
+                  "type": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "h2"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "txt_bakiye",
+                "name": "txt_bakiye",
+                "type": "text",
+                "kind": "component",
+                "props": {
+                  "content": {
+                    "type": "code",
+                    "ref": "{{ 'Kredin: ' + (Balances.kredi ?? 0) }}",
+                    "data": null
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              },
+              {
+                "elementId": "btn_uret",
+                "name": "btn_uret",
+                "type": "button",
+                "kind": "component",
+                "props": {
+                  "text": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "Rapor üret (10 kredi)"
+                  },
+                  "kind": {
+                    "type": "static",
+                    "ref": null,
+                    "data": "primary"
+                  }
+                },
+                "appearance": {
+                  "marginType": "none",
+                  "widthType": "fill"
+                },
+                "blocks": [],
+                "events": [],
+                "validations": [],
+                "stateBindings": [],
+                "children": []
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ],
+  "flowCreateArgs": {
+    "host": "page",
+    "hostId": "<kredi sayfasının id'si>",
+    "name": "rapor-uret",
+    "slug": "rapor-uret",
+    "steps": [
+      {
+        "stepId": "start",
+        "name": "start",
+        "type": "start",
+        "kind": "normal",
+        "args": {},
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "harca"
+          }
+        ]
+      },
+      {
+        "stepId": "harca",
+        "name": "harca",
+        "type": "balance-spend",
+        "kind": "normal",
+        "args": {
+          "value": "kredi",
+          "title": "10"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": "hazir"
+          },
+          {
+            "name": "error",
+            "nextStepId": "olmadi"
+          }
+        ]
+      },
+      {
+        "stepId": "hazir",
+        "name": "hazir",
+        "type": "alert",
+        "kind": "normal",
+        "args": {
+          "message": "Raporun hazır. {{ Balances.kredi }} kredin kaldı.",
+          "alertType": "success"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      },
+      {
+        "stepId": "olmadi",
+        "name": "olmadi",
+        "type": "alert",
+        "kind": "normal",
+        "args": {
+          "message": "{{ Steps.harca.error.status === 'insufficient' ? 'Krediniz yetmiyor: önce kredi satın alın.' : 'Harcama yapılamadı: ' + Steps.harca.error.message }}",
+          "alertType": "error"
+        },
+        "branches": [
+          {
+            "name": "always",
+            "nextStepId": null
+          }
+        ]
+      }
+    ],
+    "errorSteps": []
+  },
+  "bindOps": [
+    {
+      "op": "set_event",
+      "target": "btn_uret",
+      "event": "click",
+      "eventValue": "<rapor-uret akış id>"
+    }
+  ]
+}