@appaflytech/zeyrek-ai-mcp 0.0.32 → 0.0.33

package/dist/tools/caseRuntime.js

@@ -0,0 +1,89 @@
+import { guid, projectParam, environmentParam, pagingParams, readOnly, writes } from './common.js';
+import { identityHeaders } from '../platform/tokenVault.js';
+import { PlatformApiError } from '../platform/errors.js';
+import { assertProcessNotProduction } from './bpm.js';
+import { handle } from '../platform/responses.js';
+import { z } from 'zod';
+const asUserParam = z.string().min(1).optional()
+    .describe("Uygulama kullanıcısının kimliği (ham JWT ya da access_session_create'in tokenRefs'teki tok_… referansı). Vaka başlatan ve plan öğesini değiştiren bu kişi olur; verilmezse gateway'in kendi kullanıcısı.");
+const expectFailureParam = z.boolean().optional()
+    .describe('true: bu çağrıda hata BEKLENİYOR (kasıtlı negatif test: sentry sağlanmadan enable 422). Ölçüm plansız hata saymaz.');
+const planItemOperations = ['enable', 'start', 'complete', 'disable'];
+const caseInstanceOperations = [...planItemOperations, 'add-discretionary', 'update-case-file'];
+export function registerCaseRuntimeTools(server, platform) {
+    const config = platform.config;
+    server.registerTool('case_execute', {
+        title: 'Vaka başlat',
+        description: "Yayındaki vaka tanımından vaka başlatır (POST bpm/cases/{slug}/start): subjectRowId iş satırı, caseFile başlangıç değerleri (tanımdaki varsayılanların üstüne yazılır). Yanıt vaka + planItems + availableActions. process.start izni ister. İnsan görevleri görev kutusuna kind 'case-task' olarak düşer ve process_task_update ile tamamlanır. production hedefi durur (BPM-001).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            slug: z.string().min(1).max(100),
+            applicationId: guid.optional(),
+            subjectRowId: z.string().max(64).optional(),
+            caseFile: z.record(z.unknown()).optional().describe('vaka dosyası öğe id → değer'),
+            asUser: asUserParam
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, slug, applicationId, subjectRowId, caseFile, asUser }) => {
+        assertProcessNotProduction('case_execute', environment, config);
+        return platform.tenant('POST', project, `/bpm/cases/${encodeURIComponent(slug)}/start`, {
+            environment,
+            body: { applicationId, subjectRowId, caseFile },
+            headers: identityHeaders(asUser, undefined, undefined)
+        });
+    }));
+    server.registerTool('case_instance_list', {
+        title: 'Vakaları listele',
+        description: "Vakaları listeler (GET bpm/case-instances; process.view-all ister): definitionId ve state (active | completed | terminated) süzgeci. Tek vakanın plan öğeleri, defteri ve availableActions için case_instance_get.",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            definitionId: guid.optional(),
+            state: z.enum(['active', 'completed', 'terminated']).optional(),
+            ...pagingParams
+        },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, ...query }) => platform.tenant('GET', project, '/bpm/case-instances', { environment, query })));
+    server.registerTool('case_instance_get', {
+        title: 'Vakayı getir',
+        description: "Vakayı getirir (GET bpm/case-instances/{id}): state, caseFile, planItems[] (id — eylemlerdeki planItemId budur —, itemId, type, state, occurrence, taskId), events[] (vaka defteri) ve availableActions[] { action: start | complete | disable | discretionary, itemId, planItemId }. Katılımcı (başlatan, atanan, tamamlayan) ya da process.view-all görür. case_instance_update'ten önce okuyun: planItemId planItems[].id ya da availableActions[].planItemId'dir.",
+        inputSchema: { project: projectParam, environment: environmentParam, id: guid, asUser: asUserParam },
+        annotations: readOnly
+    }, handle(config, ({ project, environment, id, asUser }) => platform.tenant('GET', project, `/bpm/case-instances/${id}`, { environment, headers: identityHeaders(asUser, undefined, undefined) })));
+    server.registerTool('case_instance_update', {
+        title: 'Vakada plan öğesi eylemi',
+        description: "Vaka eylemlerinin tek kapısı: operation enable | start | complete | disable (planItemId ZORUNLU: case_instance_get planItems[].id ya da availableActions[].planItemId — enable availableActions'ta hiç yoktur, kimliği planItems[].id'den okuyun; POST …/plan-items/{planItemId}/{operation}) | add-discretionary (itemDefinitionId: isteğe bağlı plan öğesinin tanımdaki id'si; POST …/discretionary) | update-case-file (itemId ve value ZORUNLU, silmek için value: null; PUT …/case-file — yerleşimi yeniden çalıştırır, ifPart'lar yeniden değerlendirilir). Hatalar: giriş sentry'si sağlanmadan enable 422 CaseSentryNotSatisfied (lint değil, çalışma zamanı: availableActions enable listelemez); yanlış durumdaki öğe ya da kapanmış vaka 409 InstanceStateTransitionNotAllowed; human-task görev ucundan (process_task_update) tamamlanır. production hedefi durur (BPM-001).",
+        inputSchema: {
+            project: projectParam,
+            environment: environmentParam,
+            id: guid,
+            operation: z.enum(caseInstanceOperations),
+            planItemId: guid.optional().describe('enable | start | complete | disable için case_instance_get planItems[].id (ya da availableActions[].planItemId)'),
+            itemDefinitionId: z.string().max(100).optional().describe('add-discretionary için tanımdaki plan öğesi id'),
+            itemId: z.string().max(100).optional().describe('update-case-file için vaka dosyası öğe id'),
+            value: z.unknown().optional().describe('update-case-file için yeni değer (herhangi bir JSON)'),
+            asUser: asUserParam,
+            expectFailure: expectFailureParam
+        },
+        annotations: writes
+    }, handle(config, async ({ project, environment, id, operation, planItemId, itemDefinitionId, itemId, value, asUser }) => {
+        assertProcessNotProduction('case_instance_update', environment, config);
+        const headers = identityHeaders(asUser, undefined, undefined);
+        if (operation === 'add-discretionary') {
+            if (!itemDefinitionId)
+                throw new PlatformApiError("case_instance_update: 'add-discretionary' itemDefinitionId ister (istek gönderilmedi).", 400);
+            return platform.tenant('POST', project, `/bpm/case-instances/${id}/discretionary`, { environment, body: { itemDefinitionId }, headers });
+        }
+        if (operation === 'update-case-file') {
+            if (!itemId)
+                throw new PlatformApiError("case_instance_update: 'update-case-file' itemId ister (istek gönderilmedi).", 400);
+            if (value === undefined)
+                throw new PlatformApiError("case_instance_update: 'update-case-file' value ister — verilmeyen değer öğeyi siler; silmek istiyorsanız value: null gönderin (istek gönderilmedi).", 400);
+            return platform.tenant('PUT', project, `/bpm/case-instances/${id}/case-file`, { environment, body: { itemId, value }, headers });
+        }
+        if (!planItemId)
+            throw new PlatformApiError(`case_instance_update: '${operation}' planItemId ister — case_instance_get planItems[].id ya da availableActions[].planItemId (istek gönderilmedi).`, 400);
+        return platform.tenant('POST', project, `/bpm/case-instances/${id}/plan-items/${planItemId}/${operation}`, { environment, headers });
+    }));
+}

package/dist/tools/components.js

@@ -1,25 +1,81 @@
 import { guid, projectParam, environmentParam, readOnly, writes, updates, destructive } from './common.js';
-import { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, withNormalization } from '../knowledge/normalize.js';
+import { normalizeComponentDefaults, componentDefaultsNote, clampBlockSizes, blockSizeNote, normalizeHeightTypes, heightTypeNote, normalizeSizeStrings, sizeStringNote, normalizeDroppableStates, withNormalization } from '../knowledge/normalize.js';
 import { eventContractsFor, eventPayloadNote } from '../knowledge/componentEvents.js';
 import { componentPresetDefaults, readProjectTheme } from '../knowledge/themeSchema.js';
 import { knowledgeFor, knowledgeNote, APPEARANCE_TOKEN_SETS, STATE_FLAG_NOTES, INTERNAL_ROLES_BY_TYPE } from '../knowledge/componentCatalog.js';
+import { MOBILE_STATE_FLAG_NOTES, mobileComponentKnowledge } from '../knowledge/mobileComponentCatalog.js';
+import { mobileComponentEventContracts } from '../knowledge/mobileComponentEvents.js';
 import { componentUpdateBody, fetchHost, schemaParam, unwrap } from './screens.js';
 import { PlatformApiError } from '../platform/errors.js';
 import { handle } from '../platform/responses.js';
+import { applicationTypeField, resolveProfile } from '../knowledge/platform/resolve.js';
+import { mobileComponentNotes } from '../knowledge/platform/mobileRules.js';
+import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
-const typeParam = z.enum(['web', 'mobile']).optional().describe('Hedef platform; varsayılan web');
+const typeParam = z.enum(['web', 'mobile']).optional().describe('Hedef platform (ComponentType); verilmezse uygulamanın tipi — mobil uygulamada mobile');
 const kindParam = z.enum(['component', 'widget']).optional()
     .describe("component: sayfaya konan tekil eleman. widget: kendi şeması olan kapsayıcı (container/modal/drawer)");
 const widgetTypeParam = z.enum(['container', 'modal', 'drawer']).optional()
     .describe("kind:'widget' iken zorunlu");
+/**
+ * Uç `type` verilmezse WEB kataloğunu döner (`GetComponentsQuery` `Type ?? Web`); mobil uygulamanın
+ * paleti, doğrulayıcısı ve widget'ları `type=mobile` satırlarıdır. Profil mobil derse sorgu tipi
+ * taşır; web'de sorgu profil öncesiyle aynıdır (G1 kilidi).
+ */
 async function listComponents(platform, project, environment, applicationId, scope) {
     const path = scope === 'all' ? `/components/${applicationId}/all` : `/components/${applicationId}`;
+    const catalogType = scope === 'all' ? 'web' : (await resolveProfile(platform, applicationId)).profile.catalogType;
     const response = await platform.tenant('GET', project, path, {
         environment,
-        query: scope === 'all' ? undefined : { pageIndex: 0, pageLength: 999 }
+        query: scope === 'all' ? undefined : { pageIndex: 0, pageLength: 999, ...(catalogType === 'mobile' ? { type: 'mobile' } : {}) }
     });
     return response?.data ?? [];
 }
+/**
+ * CMP-002 (ARC-081) — runtime widget'ın kökünü yalnız `widget-area` (container) ya da `modal`/`drawer`
+ * tipinden tanır (`runtime-compose.ts` `getRuntimeWidgetRootNode`); düz `container` kökle kaydedilen
+ * widget her yüzeyde boş çizilir. Tipli kök yoksa düğümler Studio'nun `createWidgetRootNode`'u
+ * (`widget.functions.ts`) ile aynı şekilde bir köke sarılır: prop'lar uygulamanın kataloğundaki kök
+ * tipinin `definition.defaults`'ı, yükseklik `fixed`, kök bırakılabilir.
+ */
+function wrapWidgetRoot(schema, widgetType, components) {
+    const rootType = widgetType === 'container' ? 'widget-area' : widgetType;
+    // Runtime istenen tipin kökü yoksa öteki tipli köklere de düşer (`legacyRoot()`); tip değiştiren
+    // güncellemenin eski kökü ikinci kez sarılmaz.
+    const hasRoot = schema.some(node => node?.kind === 'component' && ['widget-area', 'modal', 'drawer'].includes(String(node.type)));
+    if (hasRoot)
+        return { schema, notes: [] };
+    const definition = (components.find(component => component.slug === rootType)?.definition ?? {});
+    const desktopBlock = Array.isArray(definition.blocks)
+        ? definition.blocks.find(block => block?.breakpoint === 1024)
+        : undefined;
+    const elementId = `${rootType}${randomUUID().slice(0, 4)}`;
+    const root = {
+        id: randomUUID(),
+        elementId,
+        name: widgetType === 'container' ? 'container' : elementId,
+        widgetType,
+        kind: 'component',
+        type: rootType,
+        children: schema,
+        events: [],
+        props: { ...(definition.defaults ?? {}) },
+        blocks: desktopBlock ? [{ breakpoint: 1024, size: desktopBlock.size, position: { x: 0, y: 0 } }] : [],
+        validations: [],
+        appearance: { heightType: 'fixed' },
+        states: { isDroppable: true },
+        stateBindings: []
+    };
+    return {
+        schema: [root],
+        notes: [`CMP-002: widget şemasında '${rootType}' kökü yoktu; ${schema.length} düğüm '${elementId}' köküne sarıldı (Studio'nun kurduğu şekil). Runtime widget'ı yalnız widget-area/modal/drawer kökünden çizer.`]
+    };
+}
+/** Uygulamanın kayıtlı bileşen slug'ları (mobil profilin MOB-003 denetimi). */
+export async function fetchCatalogSlugs(platform, project, environment, applicationId) {
+    const components = await listComponents(platform, project, environment, applicationId);
+    return new Set(components.map(component => String(component.slug ?? '')).filter(slug => slug.length > 0));
+}
 /**
  * Yerleşim normalizasyonlarının ikisi de aynı katalog listesinden beslenir; tek okumada
  * çıkarılır ki yazma yolları fazladan istek atmasın. Uygulamanın kendi sözlüğü okunur
@@ -38,12 +94,17 @@ export async function fetchComponentLayoutRules(platform, project, environment,
 export function componentLayoutRules(components) {
     const maxSizes = new Map();
     const autoHeights = new Map();
+    const droppable = new Map();
     for (const component of components) {
         const slug = typeof component.slug === 'string' ? component.slug : undefined;
         if (!slug)
             continue;
         if (typeof component.isDefaultAutoHeight === 'boolean')
             autoHeights.set(slug, component.isDefaultAutoHeight);
+        // Kap bilgisi sözlükten gelir; düğümün `states.isDroppable`ı onu izler (Studio paleti de
+        // aynı alanı katalogdan yazar). `true` gören tip kap sayılır.
+        if (typeof component.isDroppable === 'boolean')
+            droppable.set(slug, component.isDroppable);
         const blocks = (component.definition ?? {}).blocks;
         if (!Array.isArray(blocks))
             continue;
@@ -58,7 +119,7 @@ export function componentLayoutRules(components) {
             });
         }
     }
-    return { maxSizes, autoHeights };
+    return { maxSizes, autoHeights, droppable };
 }
 /**
  * Katalog okuması başarısız olsa da yazma isteği gitmeli, ama iki normalizasyonun düşüş davranışı
@@ -69,14 +130,21 @@ export function componentLayoutRules(components) {
  *   varsayılanını (`fixed`, `DesignComponentManagementSchema.cs:24`) kabul etmek demektir; en fazla
  *   sekiz tipte (auth-layout/html/image/layout/qrcode/table/text-editor/video) fazladan yükseklik
  *   üretir, atlamak ise her tipte içerik kırpar.
+ * - `states.isDroppable` atlanır — katalog okunamadığında hangi tipin kap olduğu bilinmez ve
+ *   uydurulmaz; düğüm bugünkü hâliyle yazılır.
  */
 export async function applyCatalogLayoutRules(platform, project, environment, applicationId, nodes) {
     try {
         const rules = await fetchComponentLayoutRules(platform, project, environment, applicationId);
-        return { clamped: clampBlockSizes(nodes, rules.maxSizes), heights: normalizeHeightTypes(nodes, rules.autoHeights), sizes: normalizeSizeStrings(nodes) };
+        return {
+            clamped: clampBlockSizes(nodes, rules.maxSizes),
+            heights: normalizeHeightTypes(nodes, rules.autoHeights),
+            sizes: normalizeSizeStrings(nodes),
+            states: normalizeDroppableStates(nodes, rules.droppable)
+        };
     }
     catch {
-        return { clamped: [], heights: normalizeHeightTypes(nodes, new Map()), sizes: normalizeSizeStrings(nodes) };
+        return { clamped: [], heights: normalizeHeightTypes(nodes, new Map()), sizes: normalizeSizeStrings(nodes), states: [] };
     }
 }
 /**
@@ -116,6 +184,7 @@ export function registerComponentTools(server, platform) {
     }, handle(config, async ({ project, environment, applicationId, scope, includeHidden }) => {
         const components = await listComponents(platform, project, environment, applicationId, scope);
         return {
+            ...applicationTypeField(await resolveProfile(platform, applicationId)),
             components: components
                 .filter(component => includeHidden === true || component.isHide !== true)
                 .map(component => ({
@@ -161,6 +230,15 @@ export function registerComponentTools(server, platform) {
             : [];
         const componentSlug = typeof component.slug === 'string' ? component.slug : undefined;
         const knowledge = knowledgeFor(componentSlug);
+        // Mobil uygulamada kayıt mobil kataloğun satırıdır (`listComponents` type=mobile); davranış
+        // notları web runtime'ından gelir (`knowledge` — mobil şema web sınıfını genişletir), bileşenin
+        // mobil farkları `mobileKnowledge`'ta, bütün mobil bileşenlere geçen notlar `mobileNotes`'ta (G4).
+        // Web ikizi olmayan bileşende (`app-bar`, `tooltip`…) bilgi yalnız `mobileKnowledge`'tadır; olay
+        // yükleri de önce mobil sözlükten okunur (`mobileComponentEvents.ts`).
+        const mobile = (await resolveProfile(platform, applicationId)).profile.platform === 'mobile';
+        const mobileKnowledge = mobile && componentSlug !== undefined && Object.hasOwn(mobileComponentKnowledge, componentSlug)
+            ? mobileComponentKnowledge[componentSlug]
+            : undefined;
         // S-3 — `defaults` HAM katalogdur; Studio'da bırakılan düğüm ise temanın bileşen preseti
         // kaplanmış katalogdan kurulur (`withThemeComponentDefaults`). Tema okunamazsa (uç düşer,
         // yetki yoksa) alan yanıta HİÇ girmez: uydurulmuş bir varsayılan yanlış bilgidir.
@@ -177,7 +255,7 @@ export function registerComponentTools(server, platform) {
             isDroppable: component.isDroppable,
             props: definition.props,
             defaults: definition.defaults,
-            events: eventContractsFor(componentSlug, eventNames),
+            events: eventContractsFor(componentSlug, eventNames, mobile ? mobileComponentEventContracts : undefined),
             eventPayloadNote,
             ...(knowledge
                 ? {
@@ -188,7 +266,7 @@ export function registerComponentTools(server, platform) {
                     },
                     ...(knowledge.guide ? { guide: knowledge.guide } : {})
                 }
-                : { knowledgeNote }),
+                : mobileKnowledge ? {} : { knowledgeNote }),
             ...(componentSlug && INTERNAL_ROLES_BY_TYPE[componentSlug]
                 ? {
                     internalRoles: INTERNAL_ROLES_BY_TYPE[componentSlug],
@@ -196,8 +274,9 @@ export function registerComponentTools(server, platform) {
                 }
                 : {}),
             ...(themeDefaults ? { themeDefaults } : {}),
+            ...(mobile ? { platform: 'mobile', ...(mobileKnowledge ? { mobileKnowledge } : {}), mobileNotes: mobileComponentNotes(componentSlug) } : {}),
             appearanceValues: APPEARANCE_TOKEN_SETS,
-            stateFlags: STATE_FLAG_NOTES,
+            stateFlags: mobile ? { ...STATE_FLAG_NOTES, ...MOBILE_STATE_FLAG_NOTES } : STATE_FLAG_NOTES,
             validations: definition.validations,
             sizes: definition.blocks
         };
@@ -230,21 +309,27 @@ export function registerComponentTools(server, platform) {
         if (body.kind === 'widget' && !body.widgetType) {
             throw new PlatformApiError("kind:'widget' için widgetType (container | modal | drawer) zorunludur.");
         }
+        const wrapped = body.kind === 'widget' && body.widgetType && (body.schema ?? []).length > 0
+            ? wrapWidgetRoot(body.schema ?? [], body.widgetType, await listComponents(platform, project, environment, applicationId).catch(() => []))
+            : { schema: body.schema, notes: [] };
+        body.schema = wrapped.schema;
         const fixed = normalizeComponentDefaults(body.schema);
         const catalog = (body.schema ?? []).length > 0
             ? await applyCatalogLayoutRules(platform, project, environment, applicationId, body.schema)
             : { clamped: [], heights: [], sizes: [] };
+        // Mobil uygulamanın widget'ı mobil katalog satırıdır; tip verilmezse uygulamanın tipi.
+        const defaultType = body.type ?? (await resolveProfile(platform, applicationId)).profile.catalogType;
         return platform.tenant('POST', project, `/components/${applicationId}`, {
             environment,
             body: {
                 kind: 'component',
-                type: 'web',
+                type: defaultType,
                 categories: [],
                 definition: {},
                 schema: [],
                 ...Object.fromEntries(Object.entries(body).filter(([, value]) => value !== undefined))
             }
-        }).then(response => withNormalization(response, [...componentDefaultsNote(fixed), ...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)]));
+        }).then(response => withNormalization(response, [...wrapped.notes, ...componentDefaultsNote(fixed), ...blockSizeNote(catalog.clamped), ...heightTypeNote(catalog.heights), ...sizeStringNote(catalog.sizes)]));
     }));
     server.registerTool('component_update', {
         title: 'Komponent güncelle',
@@ -279,6 +364,12 @@ export function registerComponentTools(server, platform) {
             ? await fetchHost(platform, 'component', project, environment, applicationId, String(current.id))
             : current;
         const overrides = Object.fromEntries(Object.entries(changes).filter(([, value]) => value !== undefined));
+        const widgetType = changes.widgetType ?? detailed.widgetType;
+        const wrapped = detailed.kind === 'widget' && typeof widgetType === 'string' && changes.schema !== undefined && changes.schema.length > 0
+            ? wrapWidgetRoot(changes.schema, widgetType, components)
+            : { schema: changes.schema, notes: [] };
+        if (overrides.schema !== undefined)
+            overrides.schema = wrapped.schema;
         const fixed = normalizeComponentDefaults(overrides.schema);
         const rules = componentLayoutRules(components);
         const clamped = overrides.schema === undefined ? [] : clampBlockSizes(overrides.schema, rules.maxSizes);
@@ -286,7 +377,7 @@ export function registerComponentTools(server, platform) {
         const sizes = overrides.schema === undefined ? [] : normalizeSizeStrings(overrides.schema);
         const body = componentUpdateBody({ ...detailed, applicationId }, overrides);
         await platform.tenant('PUT', project, `/components/${applicationId}/${slug}`, { environment, body });
-        return withNormalization({ slug, changed: Object.keys(overrides), preserved: { schemaNodes: body.schema.length } }, [...componentDefaultsNote(fixed), ...blockSizeNote(clamped), ...heightTypeNote(heights), ...sizeStringNote(sizes)]);
+        return withNormalization({ slug, changed: Object.keys(overrides), preserved: { schemaNodes: body.schema.length } }, [...wrapped.notes, ...componentDefaultsNote(fixed), ...blockSizeNote(clamped), ...heightTypeNote(heights), ...sizeStringNote(sizes)]);
     }));
     server.registerTool('component_delete', {
         title: 'Komponent sil',