@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

package/dist/tools/mobile.js

@@ -0,0 +1,280 @@
+import { z } from 'zod';
+import { environmentParam, guid, pagingParams, projectParam, readOnly, writes } from './common.js';
+import { fetchHost, pageUpdateBody, unwrap } from './screens.js';
+import { fetchCatalogSlugs } from './components.js';
+import { mobileTabsWarnings } from './applications.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { handle } from '../platform/responses.js';
+import { PAGE_CONTAINER_ELEMENT_ID, ensurePageContainer } from '../knowledge/normalize.js';
+import { mobileProfile, shellLessPageSkeleton } from '../knowledge/platform/mobile.js';
+import { MAX_MOBILE_TABS } from '../knowledge/platform/mobileTabs.js';
+import { forgetApplication } from '../knowledge/platform/resolve.js';
+import { readKnowledgeFile } from '../resources/knowledge.js';
+/** Ana sayfa: açıkça verilen, yoksa ilk sekme, yoksa ilk sayfa. */
+function homepageSlug(input) {
+    return input.homepage ?? input.tabs?.[0]?.pageSlug ?? input.pages[0].pageSlug;
+}
+export function mobileAppInputErrors(input) {
+    const errors = [];
+    const slugs = input.pages.map(page => page.pageSlug);
+    const repeated = slugs.filter((slug, index) => slugs.indexOf(slug) !== index);
+    if (input.pages.length === 0)
+        errors.push('pages en az bir sayfa ister');
+    if (repeated.length > 0)
+        errors.push(`pages içinde tekrar eden slug var: ${[...new Set(repeated)].join(', ')}`);
+    if (input.tabs !== undefined) {
+        const tabSlugs = input.tabs.map(tab => tab.pageSlug);
+        if (input.tabs.length === 0)
+            errors.push("tabs verildiyse en az bir öğe taşır; sekme istemiyorsan alanı hiç gönderme (yığın)");
+        if (input.tabs.length > MAX_MOBILE_TABS)
+            errors.push(`tabs en fazla ${MAX_MOBILE_TABS} öğe taşır (${input.tabs.length} verildi) — fazlası yığına açılan sayfa olarak kalmalı`);
+        for (const slug of tabSlugs.filter(slug => !slugs.includes(slug)))
+            errors.push(`tabs '${slug}' pages içinde yok — sekme yalnız kurulan bir sayfayı gösterebilir`);
+        if (tabSlugs.some((slug, index) => tabSlugs.indexOf(slug) !== index))
+            errors.push('tabs içinde tekrar eden sayfa var');
+    }
+    if (input.homepage !== undefined && !slugs.includes(input.homepage))
+        errors.push(`homepage '${input.homepage}' pages içinde yok`);
+    return errors;
+}
+export function buildMobileAppPlan(input) {
+    const home = homepageSlug(input);
+    const others = input.pages.filter(page => page.pageSlug !== home);
+    return [
+        { step: 'application_create', tool: 'application_create', summary: "type:'mobile' uygulama; backend ana sayfayı kendisi açar" },
+        { step: 'layout_create', tool: 'layout_create', summary: `kabuk: app-bar + slot${input.drawer ? ' + drawer widget (app-bar.menuTarget)' : ''}` },
+        ...others.map((page, index) => ({ step: `page_create#${index + 1}`, tool: 'page_create', summary: `'${page.pageSlug}' (${page.pageName}), layoutId ile` })),
+        { step: 'page_update#homepage', tool: 'page_update', summary: `backend'in ana sayfası → '${home}' (ad, slug, layoutId)` },
+        ...(input.tabs ? [{ step: 'application_update', tool: 'application_update', summary: `properties.mobile.tabs: ${input.tabs.map(tab => tab.pageSlug).join(' · ')}` }] : [])
+    ];
+}
+/** Kabuk ağacı örnek dosyasından okunur — örnek ile aracın kurduğu layout tek kaynaktır. */
+function shellViews(input) {
+    const example = JSON.parse(readKnowledgeFile('examples', input.drawer ? 'mobile-app-shell-drawer.json' : 'mobile-app-shell-stack.json'));
+    const views = structuredClone(example.layoutCreate.views);
+    // app-bar kabukta üst güvenli alanın içindedir (mizanpaj S1); ağaçta derinlikten bağımsız aranır.
+    const findAppBar = (nodes) => nodes.find(node => node.type === 'app-bar') ?? nodes.map(node => findAppBar(node.children ?? [])).find(Boolean);
+    const appBar = findAppBar(views);
+    if (appBar && input.title)
+        appBar.props.title = { type: 'static', ref: null, data: input.title };
+    return views;
+}
+const SHELL_TYPES = ['app-bar', 'slot'];
+/** Boş sayfanın şeması: kabuklu sayfada kök şablonu, kabuksuzda iskeletiyle (üst pay + kenar boşluğu). */
+function mobilePageSchema(shell) {
+    const schema = ensurePageContainer([], mobileProfile.layout.rootContainer).schema;
+    if (!shell && schema[0])
+        shellLessPageSkeleton(schema[0]);
+    return schema;
+}
+/**
+ * Push filtresi: `GetPushDevicesQuery` ve `SendPushNotificationCommand.audience` aynı alanları taşır
+ * (backend `PushAudienceModel`, tek kural `PushDevice.MatchesAudience`). Liste ve gönderim aynı
+ * şemayı okur ki ajan listede gördüğü kitleyi aynı alanlarla hedeflesin.
+ */
+const pushAudienceFields = {
+    channel: z.enum(['expo', 'apns', 'fcm']).optional().describe('Cihazın kanalı: expo = oynatıcıda önizleyen cihaz, apns / fcm = mağaza sürümü (iOS / Android)'),
+    platform: z.enum(['ios', 'android']).optional(),
+    language: z.string().min(1).optional().describe('Cihazın dili (küçük harf, ör. tr)'),
+    permission: z.enum(['granted', 'denied', 'undetermined']).optional().describe('Bildirim izni; gönderimde platform her zaman granted\'a daraltır'),
+    appVersion: z.string().min(1).optional(),
+    lastSeenAfter: z.string().datetime({ offset: true }).optional().describe('Bu andan sonra görülmüş cihazlar (ISO 8601)'),
+    isActive: z.boolean().optional().describe('Pasif = kanalın token\'ı yok ya da sağlayıcı cihazı ölü bildirdi (NTF-005); gönderimde platform her zaman aktife daraltır'),
+    search: z.string().min(1).optional().describe('Kurulum kimliği, uygulama kullanıcısı kimliği ya da görünen ad içinde arar')
+};
+/**
+ * NTF-001: AI production'a yazmaz (kök AGENTS.md §1). Politika kuralı DEĞİL, kapı: politika
+ * `policyOverride`/`POLICY=warn` ile gevşer, bu ret gevşememeli — `imports.ts`
+ * `assertNotProduction` ile aynı sınıf. Kuru koşu bir şey yazmadığı için serbesttir.
+ */
+function refuseProductionSend(environment, dryRun) {
+    if (dryRun || environment !== 'production')
+        return;
+    throw new PlatformApiError("notification_create [NTF-001]: production'da gerçek gönderim yapılmaz — kullanıcılara giden bildirim geri alınamaz ve production'a giden tek yol insan onayıdır. Development'ta testInstallationId ile kendi cihazınıza gönderin; production gönderimini Studio'daki Bildirimler ekranından bir insan yapar. Kitleyi saymak için dryRun: true serbesttir.", 400);
+}
+export function registerMobileTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('notification_device_list', {
+        title: 'Push cihazlarını listele',
+        description: "Mobil uygulamanın push için kayıtlı cihazlarını (kurulumlarını) son görülme sırasıyla listeler: kanal, platform, dil, izin, uygulama sürümü, aktiflik. Kanal cihazın hangi sağlayıcıdan gönderileceğini söyler (NTF-004): `expo` oynatıcıda önizleyen cihaz (easProjectId dolu), `apns` / `fcm` mağaza sürümü (appIdentifier = bundle id / paket adı). Kayıt anonimdir ve kendiliğindendir — cihaz açtığı her uygulama ve environment için kendini kaydeder; oynatıcıda dev build gerekir (Expo Go uzak push almaz), mağaza sürümü yalnız production'a kaydolur. Token yanıtta YOKTUR: gateway sır maskeleyicisi `token` ve `expoPushToken`'ı `***` yapar; varlığını `hasDevicePushToken` ve `isActive` söyler. Gönderimde kitleyi aynı alanlarla notification_create.audience'a verin. Kullanıcı/grup bağı (appUserId, tags) henüz boştur.",
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid.describe('Mobil uygulama (slug da verilebilir, gateway GUID\'e çevirir)'), ...pushAudienceFields, pageIndex: pagingParams.pageIndex, pageLength: pagingParams.pageLength.describe('Sayfa boyu; varsayılan 25') },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId, ...query }) => platform.tenant('GET', project, `/push/devices/${applicationId}`, { environment, query })));
+    server.registerTool('notification_create', {
+        title: 'Push bildirimi gönder (varsayılan kuru koşu)',
+        description: "Kitleye dile göre içerikle push bildirimi gönderir — `SendPushNotificationCommand: { dryRun, audience, content, defaultLanguage, path?, query?, androidChannel?, badge?, testInstallationId? }`. dryRun VARSAYILAN TRUE: yalnız kitleyi sayar ({ total, byLanguage }), hiçbir şey yazmaz; göndermek için dryRun: false AÇIKÇA verilir. Gerçek gönderim kuyruğa girer ve yanıt id döner; sonucu notification_history { id } ile okuyun (birkaç saniye sonra sent/failed, teslim sayıları ve hatalı cihazlar). Kitle her zaman aktif ve izinli cihazlara daraltılır; testInstallationId verilirse yalnız o kurulum (notification_device_list'teki installationId). İçerik dil → { title, body }; başlığı boş dil düşer ve o cihaz varsayılan dili alır; varsayılan dilde başlık zorunlu (NTF-002, platform 400). Dil anahtarları küçük harfe indirilir. path dokunuşta açılacak sayfanın slug'ı, query onun sorgusu. Ret: production'da dryRun: false istek gitmeden reddedilir (NTF-001).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            applicationId: guid.describe('Mobil uygulama (slug da verilebilir)'),
+            dryRun: z.boolean().optional().describe('Varsayılan true: yalnız kitleyi sayar. Göndermek için false'),
+            audience: z.object(pushAudienceFields).strict().optional().describe('notification_device_list filtreleri; boş = bütün aktif ve izinli cihazlar'),
+            content: z.record(z.object({ title: z.string().max(200), body: z.string().max(2000).optional() }).strict()).optional().describe('Dil → { title, body }; gerçek gönderimde zorunlu'),
+            defaultLanguage: z.string().min(1).max(16).optional().describe('İçeriği olmayan dildeki cihazların alacağı dil; gerçek gönderimde zorunlu'),
+            path: z.string().max(512).optional().describe('Dokunuşta açılacak sayfanın slug\'ı; boş = uygulamanın ana sayfası'),
+            query: z.string().max(1024).optional().describe('Sayfanın sorgusu, ör. id=42'),
+            androidChannel: z.string().max(64).optional(),
+            badge: z.number().int().min(0).optional(),
+            testInstallationId: z.string().max(64).optional().describe('Yalnız bu kuruluma gönder (kendi cihazınızla deneme)')
+        },
+        annotations: writes
+    }, handle(config, ({ project, environment, applicationId, dryRun = true, ...body }) => {
+        refuseProductionSend(environment ?? config.defaultEnvironment, dryRun);
+        return platform.tenant('POST', project, `/push/notifications/${applicationId}`, { environment, body: { ...body, dryRun } });
+    }));
+    server.registerTool('notification_history', {
+        title: 'Push gönderim geçmişi',
+        description: "Uygulamanın push gönderimlerini en yeniden listeler (durum queued/sending/sent/failed, hedef/kabul/teslim/hata sayıları). id verilirse tek gönderimin ayrıntısı: dil başına içerik ve ilk 100 hatalı cihaz (deviceId + sağlayıcının hatası, ör. DeviceNotRegistered, BadDeviceToken, UNREGISTERED). `sent` yalnız hattın bittiğini söyler: errorCount > 0 ise bazı cihazlara ulaşmamıştır. Teslim makbuzu (okCount) yalnız `expo` kanalında vardır ve gönderimden ~15 dk sonra işlenir; `apns` / `fcm` sonucu gönderim anında kesindir (sentCount). Hata `credentials-missing` ise o kanalın push kimliği yok ya da okunamıyor (NTF-004): kimlik Studio › Yayınla › Hesaplar ve kimlik bilgileri'nde bir insan tarafından yüklenir, ajan yükleyemez; durumu mobile_build_start { dryRun: true } (hedef testflight | internal) ön kontrolünün P-11 satırı gösterir; satır yoksa mobile_store_get { manifest: true } yanıtında manifest.push hazır olduğunu söyler.",
+        inputSchema: { project: projectParam, environment: environmentParam, applicationId: guid.describe('Mobil uygulama (slug da verilebilir)'), id: guid.optional().describe('Tek gönderimin ayrıntısı için'), pageIndex: pagingParams.pageIndex },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, applicationId, id, ...query }) => platform.tenant('GET', project, id ? `/push/notifications/${applicationId}/${id}` : `/push/notifications/${applicationId}`, { environment, query })));
+    server.registerTool('mobile_app_create', {
+        title: 'Mobil uygulamayı kabuğuyla kur',
+        description: "Mobil uygulamayı (type:'mobile'), kabuk layout'unu (app-bar + slot; drawer:true ise çekmece widget'ı), sayfalarını ve isteğe bağlı sekme ayarını (properties.mobile.tabs) TEK çağrıda kurar. Sıra: application_create → layout_create → page_create (sayfalar layoutId ile doğar) → backend'in açtığı ana sayfa seçilen ana sayfaya dönüştürülür (yetim sayfa kalmaz) → application_update (yalnız tabs verildiyse). tabs yoksa gezinme yığındır. dryRun:true planı döner, hiçbir şey yazmaz. Platformda işlem yoktur: hata olursa yanıt completed (kurulanlar), failed (düşen adım) ve remaining (kalanlar) taşır — kalanları tekil araçlarla tamamlayın. Kabuk bileşenleri (app-bar, slot) mobil katalogda yoksa layout atlanır ve uyarı döner. Rehber: platform_guide('mobile').",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            projectId: guid,
+            slug: z.string().min(1),
+            name: z.string().min(1),
+            color: z.string().optional(),
+            pages: z.array(z.object({ pageSlug: z.string().min(1), pageName: z.string().min(1) })).min(1),
+            tabs: z.array(z.object({ pageSlug: z.string().min(1), label: z.string().optional(), icon: z.string().optional() })).optional()
+                .describe(`1-${MAX_MOBILE_TABS} sekme; her pageSlug pages içinden. Verilmezse sekme çubuğu yok (yığın). label 't:<anahtar>' ile yazılırsa çeviri sözlüğünden çözülür (platform_guide('mobile') §Çok dil).`),
+            drawer: z.boolean().optional().describe("true: layout'a drawer widget'ı + app-bar.menuTarget (çekmece)"),
+            title: z.string().optional().describe('app-bar başlığı (bütün sayfalar için sabit metin). Boşsa çubuk başlıksız çizilir — sayfa adına düşen bir yedek YOKTUR; sayfaya göre değişen başlık için title\'ı bir değişkene bağlayın ya da başlığı sayfanın içine text olarak koyun'),
+            homepage: z.string().optional().describe('Ana sayfanın pageSlug\'ı; varsayılan ilk sekme, sekme yoksa ilk sayfa'),
+            dryRun: z.boolean().optional()
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, projectId, slug, name, color, pages, tabs, drawer, title, homepage, dryRun }) => {
+        const input = { pages, ...(tabs ? { tabs } : {}), ...(drawer ? { drawer } : {}), ...(homepage ? { homepage } : {}), ...(title ? { title } : {}) };
+        const errors = mobileAppInputErrors(input);
+        if (errors.length > 0)
+            throw new PlatformApiError(`mobile_app_create: ${errors.join(' · ')}. Hiçbir şey yazılmadı.`, 400);
+        const plan = buildMobileAppPlan(input);
+        if (dryRun)
+            return { dryRun: true, plan };
+        const completed = [];
+        const skipped = new Set();
+        const warnings = [];
+        const home = homepageSlug(input);
+        const pageIds = new Map();
+        let applicationId;
+        let homepageId;
+        let layoutId;
+        let current = 'application_create';
+        try {
+            const created = unwrap(await platform.org('POST', `/applications/${projectId}`, {
+                environment,
+                body: { slug, name, type: 'mobile', ...(color ? { color } : {}) }
+            }));
+            applicationId = String(created.id ?? '');
+            homepageId = typeof created.homepageId === 'string'
+                ? created.homepageId
+                : String(created.homepage?.id ?? '');
+            forgetApplication(platform);
+            if (!applicationId || !homepageId)
+                throw new PlatformApiError('application_create yanıtı uygulama ya da ana sayfa kimliği taşımıyor — application_get ile kontrol edin.');
+            completed.push({ step: 'application_create', id: applicationId });
+            current = 'layout_create';
+            const catalog = await fetchCatalogSlugs(platform, project, environment, applicationId);
+            const missing = SHELL_TYPES.filter(type => !catalog.has(type));
+            if (missing.length > 0) {
+                skipped.add('layout_create');
+                warnings.push(`MOB-003 (uyarı) — kabuk bileşenleri mobil katalogda yok (${missing.join(', ')}): layout KURULMADI, sayfalar layout'suz açıldı. Katalog yazıldıktan sonra kabuğu ngapps://examples/mobile-app-shell-${input.drawer ? 'drawer' : input.tabs ? 'tab' : 'stack'} ile layout_create + page_update(layoutId) olarak kurun.`);
+            }
+            else {
+                const layout = unwrap(await platform.tenant('POST', project, `/layouts/${applicationId}`, {
+                    environment,
+                    body: { name: `${name} kabuğu`, views: shellViews(input), events: [], parameters: null }
+                }));
+                layoutId = String(layout.id ?? '');
+                completed.push({ step: 'layout_create', id: layoutId });
+            }
+            const others = pages.filter(page => page.pageSlug !== home);
+            for (const [index, page] of others.entries()) {
+                current = `page_create#${index + 1}`;
+                const saved = unwrap(await platform.tenant('POST', project, `/pages/${applicationId}`, {
+                    environment,
+                    body: {
+                        name: page.pageName,
+                        slug: page.pageSlug,
+                        browserTitle: '',
+                        browserTitleKey: '',
+                        layoutId: layoutId ?? null,
+                        roleIds: [],
+                        middlewareIds: [],
+                        events: [],
+                        schema: mobilePageSchema(layoutId !== undefined)
+                    }
+                }));
+                pageIds.set(page.pageSlug, String(saved.id ?? ''));
+                completed.push({ step: current, id: String(saved.id ?? '') });
+            }
+            current = 'page_update#homepage';
+            const homePage = pages.find(page => page.pageSlug === home);
+            const existing = await fetchHost(platform, 'page', project, environment, applicationId, homepageId);
+            // Backend'in açtığı ana sayfanın kökü sözleşme dışıdır (`size: grow`, S-16). Sayfa henüz boşsa kök
+            // öteki sayfalarla aynı şablonla yeniden yazılır; içerik varsa dokunulmaz.
+            const homeSchema = existing.schema;
+            const blankHome = Array.isArray(homeSchema) && homeSchema.length === 1 && homeSchema[0]?.elementId === PAGE_CONTAINER_ELEMENT_ID && (homeSchema[0].children ?? []).length === 0;
+            await platform.tenant('PUT', project, `/pages/${applicationId}/${homepageId}`, {
+                environment,
+                body: pageUpdateBody(existing, {
+                    name: homePage.pageName,
+                    slug: homePage.pageSlug,
+                    layoutId: layoutId ?? null,
+                    ...(blankHome ? { schema: mobilePageSchema(layoutId !== undefined) } : {})
+                })
+            });
+            pageIds.set(home, homepageId);
+            completed.push({ step: current, id: homepageId });
+            if (tabs) {
+                current = 'application_update';
+                const properties = {
+                    mobile: {
+                        tabs: {
+                            enabled: true,
+                            style: 'default',
+                            showLabels: true,
+                            items: tabs.map(tab => ({ page: pageIds.get(tab.pageSlug), ...(tab.label ? { label: tab.label } : {}), ...(tab.icon ? { icon: tab.icon } : {}) }))
+                        }
+                    }
+                };
+                warnings.push(...await mobileTabsWarnings(platform, applicationId, platform.resolveProject(project), homepageId, properties));
+                await platform.org('PUT', `/applications/${applicationId}`, {
+                    environment,
+                    body: { slug, name, homepageId, ...(color ? { color } : {}), properties }
+                });
+                forgetApplication(platform, applicationId);
+                completed.push({ step: current });
+            }
+        }
+        catch (error) {
+            if (completed.length === 0)
+                throw error;
+            const done = new Set(completed.map(entry => entry.step));
+            return {
+                applicationId,
+                ...(layoutId ? { layoutId } : {}),
+                completed,
+                failed: { step: current, error: error instanceof Error ? error.message : String(error) },
+                remaining: plan.map(step => step.step).filter(step => !done.has(step) && !skipped.has(step) && step !== current),
+                ...(warnings.length > 0 ? { warnings } : {}),
+                note: 'Kurulum yarıda kaldı: completed kurulanları, remaining eksik adımları söyler. Kalanları tekil araçlarla tamamlayın (page_create, page_update, application_update) — mobile_app_create aynı slug ile tekrar çağrılırsa uygulamayı ikinci kez açmaya çalışır.'
+            };
+        }
+        return {
+            applicationId,
+            homepageId,
+            ...(layoutId ? { layoutId } : {}),
+            applicationType: 'mobile',
+            pages: pages.map(page => ({ slug: page.pageSlug, name: page.pageName, id: pageIds.get(page.pageSlug), ...(page.pageSlug === home ? { homepage: true } : {}) })),
+            ...(tabs ? { tabs: tabs.map(tab => tab.pageSlug) } : {}),
+            completed,
+            ...(warnings.length > 0 ? { warnings } : {}),
+            next: "Ekranları page_schema_patch ile doldurun; doğrulama page_screenshot (mobilde varsayılan device: 'phone'). platform_guide('mobile')."
+        };
+    }));
+}