@appaflytech/zeyrek-ai-mcp 0.0.23 → 0.0.24

package/dist/tools/screens.js

@@ -9,6 +9,81 @@ export const schemaParam = z.array(z.record(z.unknown()))
 export const eventsParam = z.array(z.record(z.unknown()))
     .describe("Sayfa/layout düzeyi olaylar: [{ name, value }] — value bir flow id'sidir");
 export const modeParam = z.enum(['summary', 'subtree', 'full']).optional().describe("summary (varsayılan): yalnız id/elementId/name/type ağacı — hedef bulmak için bunu kullanın. subtree: componentId ile tek alt ağaç. full: tüm şema.");
+/**
+ * Şema ağacındaki TÜM düğümler (kök + iç içe çocuklar); page_get, page_create özeti, page_update
+ * ve page_schema_get aynı sayımı kullanır. Parçalı okumanın `deferred` yer tutucuları düğüm değildir.
+ */
+export function countSchemaNodes(nodes) {
+    return (nodes ?? []).reduce((total, node) => node.deferred === true ? total : total + 1 + countSchemaNodes(node.children), 0);
+}
+function schemaNodeKey(node) {
+    return typeof node.elementId === 'string' ? node.elementId : String(node.id);
+}
+function schemaNodeKeys(nodes) {
+    return (nodes ?? []).flatMap(node => [schemaNodeKey(node), ...schemaNodeKeys(node.children)]);
+}
+/** `stored` ağacında olup `sent` ağacında olmayan düğümlerin elementId'leri, ön-sırayla (PAGE-037). */
+export function missingElementIds(stored, sent) {
+    const kept = new Set(schemaNodeKeys(sent));
+    return schemaNodeKeys(stored).filter(key => !kept.has(key));
+}
+/**
+ * ZM-28: şemayı her biri `budgetChars` karakteri (JSON uzunluğu, `shrink` ile aynı ölçü) aşmayan
+ * parçalara böler. Ön-sıra ve deterministik: alt ağacı sığan düğüm BÜTÜN alınır, sığmayan kabuk olarak
+ * yazılır ve çocuklarına inilir; parçaların birleşimi orijinal şemanın birebir aynısıdır.
+ */
+export function splitSchemaIntoParts(schema, budgetChars) {
+    const parts = [];
+    let current = [];
+    let currentChars = 2;
+    const place = (item, chars) => {
+        if (current.length > 0 && currentChars + 1 + chars > budgetChars) {
+            parts.push(current);
+            current = [];
+            currentChars = 2;
+        }
+        currentChars += (current.length > 0 ? 1 : 0) + chars;
+        current.push(item);
+    };
+    const visit = (node, parentElementId, index) => {
+        const whole = { parentElementId, index, node };
+        const wholeChars = JSON.stringify(whole).length;
+        if (2 + wholeChars <= budgetChars) {
+            place(whole, wholeChars);
+            return;
+        }
+        const children = Array.isArray(node.children) ? node.children : [];
+        const shell = {
+            parentElementId,
+            index,
+            node: { ...node, children: children.map(child => ({ elementId: schemaNodeKey(child), deferred: true })) }
+        };
+        const shellChars = JSON.stringify(shell).length;
+        if (children.length === 0 || 2 + shellChars > budgetChars) {
+            throw new PlatformApiError(`'${schemaNodeKey(node)}' (${String(node.type)}) düğümünün kendi gövdesi ${children.length === 0 ? wholeChars : shellChars} karakter; parça bütçesi ${budgetChars} karakter olduğu için tek düğüm bile bir yanıta sığmıyor. Düğümün büyük prop'unu page_schema_patch (replace_prop) ile küçültün ya da parçalara bölün; sonra cursor:'0' ile yeniden okuyun.`, 400);
+        }
+        place(shell, shellChars);
+        children.forEach((child, childIndex) => visit(child, schemaNodeKey(node), childIndex));
+    };
+    schema.forEach((node, index) => visit(node, null, index));
+    if (current.length > 0 || parts.length === 0)
+        parts.push(current);
+    return parts;
+}
+/** Opak parçalı okuma cursor'ı: sürüm değişince eski cursor reddedilir. */
+export function encodeSchemaCursor(version, partIndex) {
+    return `${version}:${partIndex}`;
+}
+/** `'0'` sürümsüz ilk parçadır; `<sürüm>:<parça>` sürümü taşır. Çözülemeyen cursor `undefined`. */
+export function decodeSchemaCursor(cursor) {
+    if (/^\d+$/.test(cursor))
+        return { partIndex: Number(cursor) };
+    const separator = cursor.lastIndexOf(':');
+    const partIndex = cursor.slice(separator + 1);
+    if (separator < 0 || !/^\d+$/.test(partIndex))
+        return undefined;
+    return { version: cursor.slice(0, separator), partIndex: Number(partIndex) };
+}
 /**
  * Ağacı yalnız kimlik alanlarına indirger; hedef aramak için okunur boyutta tutar.
  * `styleSource` verilirse (undefined DEĞİLSE) her düğüme efektif stil raporu da
@@ -102,6 +177,11 @@ export function flowPath(host, applicationId, hostId, flowId) {
             : `/components/${applicationId}/${hostId}/flows`;
     return flowId ? `${root}/${flowId}` : root;
 }
+/**
+ * Sayfa PUT gövdesi okunan sayfadan kurulur ve o sayfanın sürümünü `baseVersion` olarak taşır:
+ * platform sürümsüz sayfa PUT'unu reddeder (`plans/mobil-plantcare-acigi` b-05, K11). Gövde
+ * okunduğu andaki sayfanın üstüne yazar; ajanın planladığı sürümü `page_update` kendisi koyar.
+ */
 export function pageUpdateBody(page, overrides = {}) {
     const layout = (page.layout ?? {});
     return {
@@ -116,6 +196,7 @@ export function pageUpdateBody(page, overrides = {}) {
         middlewareIds: page.middlewareIds ?? [],
         roleIds: Array.isArray(page.roleIds) ? page.roleIds : identifiers(page.roles),
         layoutId: page.layoutId ?? layout.id ?? null,
+        baseVersion: page.version === undefined || page.version === null ? undefined : String(page.version),
         ...overrides
     };
 }

package/package.json

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