@appaflytech/zeyrek-ai-mcp 0.0.30 → 0.0.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (203) hide show
  1. package/.env.example +0 -15
  2. package/README.md +5 -5
  3. package/dist/config.js +0 -37
  4. package/dist/index.js +0 -2
  5. package/dist/knowledge/backendConstraints.js +1 -18
  6. package/dist/knowledge/boxSections.js +184 -0
  7. package/dist/knowledge/componentCatalog.js +232 -562
  8. package/dist/knowledge/componentEvents.js +21 -141
  9. package/dist/knowledge/layoutSummary.js +2 -140
  10. package/dist/knowledge/normalize.js +67 -236
  11. package/dist/knowledge/outlines.js +0 -36
  12. package/dist/knowledge/policy.js +4 -18
  13. package/dist/knowledge/reservedTables.js +0 -79
  14. package/dist/knowledge/rules.js +21 -319
  15. package/dist/knowledge/schemaGuard.js +0 -11
  16. package/dist/knowledge/styleResolve.js +38 -55
  17. package/dist/knowledge/themeResolve.js +3 -3
  18. package/dist/observability/trace.js +3 -6
  19. package/dist/platform/diagnostics.js +4 -10
  20. package/dist/platform/domSummary.js +1 -1
  21. package/dist/platform/errors.js +10 -162
  22. package/dist/platform/http.js +8 -29
  23. package/dist/platform/responses.js +5 -39
  24. package/dist/platform/{capture/capture.js → screenshot.js} +519 -105
  25. package/dist/platform/secrets.js +1 -17
  26. package/dist/platform/strictArguments.js +12 -68
  27. package/dist/platform/tokenVault.js +4 -187
  28. package/dist/resources/examples/layout-app-shell.json +707 -229
  29. package/dist/resources/examples/page-detail-profile.json +1 -2
  30. package/dist/resources/examples/page-dynamic-form.json +2 -3
  31. package/dist/resources/examples/page-flex-sections.json +1 -1
  32. package/dist/resources/examples/page-html-embed.json +1 -1
  33. package/dist/resources/examples/workflow-basic.json +2 -8
  34. package/dist/resources/guides/component.md +4 -91
  35. package/dist/resources/guides/entity.md +8 -50
  36. package/dist/resources/guides/expressions.md +5 -14
  37. package/dist/resources/guides/functions.md +1 -1
  38. package/dist/resources/guides/getting-started.md +1 -38
  39. package/dist/resources/guides/layout.md +58 -55
  40. package/dist/resources/guides/microservice.md +2 -81
  41. package/dist/resources/guides/middleware.md +2 -44
  42. package/dist/resources/guides/page.md +75 -454
  43. package/dist/resources/guides/theme.md +2 -8
  44. package/dist/resources/guides/translation.md +1 -1
  45. package/dist/resources/guides/workflow.md +1 -58
  46. package/dist/resources/rules.js +5 -11
  47. package/dist/resources/schema-fingerprint.json +5 -7
  48. package/dist/resources/schemas/CreateEntityCommand.json +0 -118
  49. package/dist/resources/schemas/CreateMicroserviceCommand.json +1 -13
  50. package/dist/resources/schemas/CreateQueryCommand.json +0 -4
  51. package/dist/resources/schemas/CreateWorkflowCommand.json +1 -143
  52. package/dist/resources/schemas/DataJobDto.json +1 -6
  53. package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +1 -21
  54. package/dist/resources/schemas/MicroserviceDto.json +3 -15
  55. package/dist/resources/schemas/PreviewMicroserviceCommand.json +1 -10
  56. package/dist/resources/schemas/PreviewWorkflowCommand.json +1 -22
  57. package/dist/resources/schemas/StepDto.json +1 -22
  58. package/dist/resources/schemas/UpdateEntityCommand.json +0 -118
  59. package/dist/resources/schemas/UpdateMicroserviceCommand.json +1 -13
  60. package/dist/resources/schemas/UpdateQueryCommand.json +0 -4
  61. package/dist/resources/schemas/UpdateViewCommand.json +2 -0
  62. package/dist/resources/schemas/UpdateWorkflowCommand.json +1 -143
  63. package/dist/server.js +1 -27
  64. package/dist/tools/access.js +2 -369
  65. package/dist/tools/applications.js +3 -60
  66. package/dist/tools/common.js +0 -7
  67. package/dist/tools/components.js +14 -118
  68. package/dist/tools/datasources.js +3 -3
  69. package/dist/tools/dependencies.js +1 -1
  70. package/dist/tools/deployments.js +2 -2
  71. package/dist/tools/designSchemaPatch.js +18 -34
  72. package/dist/tools/dtos.js +5 -36
  73. package/dist/tools/entities.js +12 -79
  74. package/dist/tools/externalComponents.js +5 -26
  75. package/dist/tools/flows.js +14 -122
  76. package/dist/tools/folders.js +1 -1
  77. package/dist/tools/imports.js +2 -5
  78. package/dist/tools/layouts.js +17 -50
  79. package/dist/tools/merges.js +1 -1
  80. package/dist/tools/microservices.js +25 -77
  81. package/dist/tools/pages.js +112 -465
  82. package/dist/tools/platformInfo.js +8 -27
  83. package/dist/tools/projects.js +9 -71
  84. package/dist/tools/rows.js +13 -69
  85. package/dist/tools/schemaOps.js +1 -61
  86. package/dist/tools/screenWrite.js +8 -37
  87. package/dist/tools/screens.js +5 -95
  88. package/dist/tools/templates.js +1 -26
  89. package/dist/tools/translations.js +1 -1
  90. package/dist/tools/variables.js +5 -11
  91. package/dist/tools/workflows.js +5 -10
  92. package/package.json +2 -2
  93. package/dist/knowledge/access.js +0 -802
  94. package/dist/knowledge/case.js +0 -41
  95. package/dist/knowledge/connectDataBind.js +0 -819
  96. package/dist/knowledge/connectDataDefinition.js +0 -341
  97. package/dist/knowledge/connectDataExecute.js +0 -93
  98. package/dist/knowledge/connectDataRules.js +0 -128
  99. package/dist/knowledge/decision.js +0 -121
  100. package/dist/knowledge/expressionPrelude.js +0 -59
  101. package/dist/knowledge/microserviceParameters.js +0 -58
  102. package/dist/knowledge/mining.js +0 -94
  103. package/dist/knowledge/mobileComponentCatalog.js +0 -859
  104. package/dist/knowledge/mobileComponentEvents.js +0 -239
  105. package/dist/knowledge/platform/lint.js +0 -385
  106. package/dist/knowledge/platform/mobile.js +0 -142
  107. package/dist/knowledge/platform/mobileLayoutLint.js +0 -324
  108. package/dist/knowledge/platform/mobileRules.js +0 -231
  109. package/dist/knowledge/platform/mobileSpacing.js +0 -82
  110. package/dist/knowledge/platform/mobileTabs.js +0 -108
  111. package/dist/knowledge/platform/nativeBoxModel.js +0 -44
  112. package/dist/knowledge/platform/profile.js +0 -25
  113. package/dist/knowledge/platform/resolve.js +0 -122
  114. package/dist/knowledge/platform/web.js +0 -39
  115. package/dist/knowledge/process.js +0 -510
  116. package/dist/knowledge/rowFilter.js +0 -43
  117. package/dist/knowledge/styleResolveNative.js +0 -527
  118. package/dist/platform/argumentAliases.js +0 -128
  119. package/dist/platform/bodyFile.js +0 -103
  120. package/dist/platform/capture/actions.js +0 -333
  121. package/dist/platform/capture/browser.js +0 -1
  122. package/dist/platform/capture/console-log.js +0 -122
  123. package/dist/platform/capture/index.js +0 -11
  124. package/dist/platform/capture/readiness.js +0 -103
  125. package/dist/platform/capture/summary.js +0 -77
  126. package/dist/platform/capture/target.js +0 -5
  127. package/dist/platform/capture/targets/studio-mobile.js +0 -15
  128. package/dist/platform/capture/targets/studio-web.js +0 -5
  129. package/dist/platform/impersonation.js +0 -45
  130. package/dist/platform/jsonArray.js +0 -24
  131. package/dist/platform/schemaReadMemory.js +0 -60
  132. package/dist/resources/examples/bpm-gorev-kontrol.json +0 -294
  133. package/dist/resources/examples/bpm-iso-dokuman.json +0 -228
  134. package/dist/resources/examples/bpm-satinalma.json +0 -376
  135. package/dist/resources/examples/connect-data-convert-verify.json +0 -107
  136. package/dist/resources/examples/connect-data-dropdown-roles.json +0 -66
  137. package/dist/resources/examples/connect-data-edit-m2m.json +0 -73
  138. package/dist/resources/examples/connect-data-query-params.json +0 -50
  139. package/dist/resources/examples/connect-data-table-entity.json +0 -147
  140. package/dist/resources/examples/connect-data-workflow-microservice.json +0 -65
  141. package/dist/resources/examples/mobile-app-shell-drawer.json +0 -243
  142. package/dist/resources/examples/mobile-app-shell-stack.json +0 -157
  143. package/dist/resources/examples/mobile-app-shell-tab.json +0 -208
  144. package/dist/resources/examples/mobile-form-screen.json +0 -365
  145. package/dist/resources/examples/mobile-list-detail-form.json +0 -672
  146. package/dist/resources/guides/access.md +0 -796
  147. package/dist/resources/guides/bpm.md +0 -686
  148. package/dist/resources/guides/case.md +0 -153
  149. package/dist/resources/guides/decision.md +0 -185
  150. package/dist/resources/guides/mobile-layout.md +0 -193
  151. package/dist/resources/guides/mobile.md +0 -495
  152. package/dist/resources/read.js +0 -41
  153. package/dist/resources/schemas/AccessExplanationDto.json +0 -144
  154. package/dist/resources/schemas/AccessMatrixDto.json +0 -170
  155. package/dist/resources/schemas/AccessPermissionDto.json +0 -57
  156. package/dist/resources/schemas/AccessPolicyDto.json +0 -223
  157. package/dist/resources/schemas/AccessResourceDto.json +0 -86
  158. package/dist/resources/schemas/AppSessionDto.json +0 -53
  159. package/dist/resources/schemas/ConnectDataDescribeDto.json +0 -344
  160. package/dist/resources/schemas/ConnectDataRequestModel.json +0 -202
  161. package/dist/resources/schemas/ConnectDataResultDto.json +0 -421
  162. package/dist/resources/schemas/ConnectorCredentialDto.json +0 -70
  163. package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +0 -37
  164. package/dist/resources/schemas/CreateAccessPolicyCommand.json +0 -209
  165. package/dist/resources/schemas/CreateDecisionCommand.json +0 -221
  166. package/dist/resources/schemas/CreateProcessDefinitionCommand.json +0 -1337
  167. package/dist/resources/schemas/DecisionDto.json +0 -302
  168. package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +0 -28
  169. package/dist/resources/schemas/ExplainAccessQuery.json +0 -33
  170. package/dist/resources/schemas/GenerateProcessDocumentCommand.json +0 -116
  171. package/dist/resources/schemas/OrganizationProjectDto.json +0 -335
  172. package/dist/resources/schemas/OrganizationSchemaDto.json +0 -196
  173. package/dist/resources/schemas/OrganizationSchemaVersionDto.json +0 -207
  174. package/dist/resources/schemas/PatchProcessDefinitionCommand.json +0 -76
  175. package/dist/resources/schemas/ProcessDefinitionDto.json +0 -1480
  176. package/dist/resources/schemas/ProcessSimulationDto.json +0 -96
  177. package/dist/resources/schemas/SaveConnectorCredentialCommand.json +0 -90
  178. package/dist/resources/schemas/SaveProcessEventSourceCommand.json +0 -61
  179. package/dist/resources/schemas/SaveProcessMailSourceCommand.json +0 -89
  180. package/dist/resources/schemas/SignProcessTaskCommand.json +0 -73
  181. package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +0 -92
  182. package/dist/resources/schemas/UpdateAccessPolicyCommand.json +0 -209
  183. package/dist/resources/schemas/UpdateDecisionCommand.json +0 -216
  184. package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +0 -1357
  185. package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +0 -1339
  186. package/dist/tools/accessOperations.js +0 -135
  187. package/dist/tools/accessPolicies.js +0 -170
  188. package/dist/tools/accessRuntime.js +0 -203
  189. package/dist/tools/bpm.js +0 -343
  190. package/dist/tools/bpmGovernance.js +0 -266
  191. package/dist/tools/bpmOperations.js +0 -230
  192. package/dist/tools/bpmReporting.js +0 -154
  193. package/dist/tools/bpmRouting.js +0 -150
  194. package/dist/tools/bpmRuntime.js +0 -396
  195. package/dist/tools/case.js +0 -178
  196. package/dist/tools/caseRuntime.js +0 -89
  197. package/dist/tools/connectData.js +0 -449
  198. package/dist/tools/connectors.js +0 -193
  199. package/dist/tools/decisions.js +0 -206
  200. package/dist/tools/mobile.js +0 -221
  201. package/dist/tools/modules.js +0 -48
  202. package/dist/tools/organizationStructure.js +0 -137
  203. package/dist/tools/profileWrite.js +0 -92
@@ -3,13 +3,6 @@
3
3
  * anahtarları da yakalıyordu. Günlükte zararsızdı, tool yanıtında veri kaybı olurdu.
4
4
  */
5
5
  export const secretKeyPattern = /password|passwd|secret|token|authorization|api[-_]?key|credential|connection[-_]?string/i;
6
- /**
7
- * Sırrın DEĞERİNİ değil adını, yerini ya da türünü taşıyan anahtarlar: `credentialRef`, `tokenUrl`,
8
- * `apiKeyHeader`, `secretFields`, `credentialKind`. Maskelenirlerse süreç tanımındaki
9
- * `connector.credentialRef` get → update turunda `***` olarak geri yazılır ve düğüm kasayı bulamaz
10
- * (BPM-017, Faz 8 incelemesi). Yalnız yanıt maskesinde uygulanır; günlük maskesi (`trace.ts`) geniş kalır.
11
- */
12
- export const secretNameKeyPattern = /(ref|refs|url|uri|header|fields|kind|name|names|id|ids)$/i;
13
6
  import { looksLikeJwt, rememberToken } from './tokenVault.js';
14
7
  const maskedValue = '***';
15
8
  const maxPaths = 20;
@@ -23,7 +16,7 @@ function walk(value, path, masked, refs, depth) {
23
16
  const result = {};
24
17
  for (const [key, entry] of Object.entries(value)) {
25
18
  const child = path === '' ? key : `${path}.${key}`;
26
- if (secretKeyPattern.test(key) && !secretNameKeyPattern.test(key) && entry !== null && entry !== undefined && entry !== '') {
19
+ if (secretKeyPattern.test(key) && entry !== null && entry !== undefined && entry !== '') {
27
20
  if (masked.length < maxPaths)
28
21
  masked.push(child);
29
22
  // Maskelenen değer bir JWT ise kimlik testinin yolu kapanmasın: jeton kasada tutulur ve
@@ -45,12 +38,3 @@ export function maskSecrets(payload) {
45
38
  const tokenRefs = {};
46
39
  return { payload: walk(payload, '', masked, tokenRefs, 0), masked, tokenRefs };
47
40
  }
48
- /**
49
- * Serbest METİNDEKİ kimlik parçaları (konsol satırı, hata yığını): JWT biçimli dize ve `Bearer …`.
50
- * `maskSecrets` anahtar adına bakar; tarayıcı konsolu anahtarsız düz metin taşır (g-06).
51
- */
52
- export function maskSecretText(text) {
53
- return text
54
- .replace(/Bearer\s+[A-Za-z0-9._~+/=-]+/gi, `Bearer ${maskedValue}`)
55
- .replace(/\b[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\b/g, maskedValue);
56
- }
@@ -1,11 +1,5 @@
1
1
  import { z } from 'zod';
2
2
  import { diagnosticsParam, runWithDiagnostics } from './diagnostics.js';
3
- import { applyArgumentAliases, closestArgument, runWithArgumentNotes } from './argumentAliases.js';
4
- import { BODY_FILE_ARGUMENTS, bodyFileParam, loadBodyFile } from './bodyFile.js';
5
- import { PlatformApiError } from './errors.js';
6
- import { logError } from '../observability/trace.js';
7
- /** Doğrulanmış argümanlara takılan çeviri notları (`ArgumentNotes`); JSON'a ve platform isteğine girmez. */
8
- const ARGUMENT_NOTES = Symbol('argumentNotes');
9
3
  /**
10
4
  * `writes`/`updates` açıklamalı ama KAYIT yazmayan tool'lar: çalıştırma, önizleme, dışa aktarma, indirme,
11
5
  * bağlantı testi. Yanıtlarında yazma tanılaması (silentlyDropped) yoktur; parametre yalnız tool listesini
@@ -31,75 +25,25 @@ function isRawShape(value) {
31
25
  * olmayan bir sorgu kusuruna yönlendirdi. Tek tek tool'lara alan eklemek sınıfı kapatmaz; sessizlik
32
26
  * burada, SDK'ya şema verilmeden önce kaldırılır.
33
27
  */
34
- export function rejectUnknownArguments(server, platform) {
28
+ export function rejectUnknownArguments(server) {
35
29
  const registerTool = server.registerTool.bind(server);
36
- // Zorunlu gövde argümanı `bodyFile` açıkken şemada isteğe bağlı yayınlanır (yoksa şemaya uyan istemci
37
- // gövdeyi satır içinde yollamak zorunda kalır ve `bodyFile` "birlikte verilemez" ile reddedilirdi);
38
- // zorunluluk dosya okunduktan sonra burada denetlenir.
39
- const requiredBodies = new Map();
40
- // g-07/g-08: `bodyFile` ve takma ad tablosu SDK'nın strict doğrulamasından ÖNCE koşmalı — sonra
41
- // koşsa yanlış ad zaten reddedilmiş, dosyadan gelen gövde doğrulanmamış olur. SDK doğrulamayı
42
- // `validateToolInput` içinde yapar; çeviri orada uygulanır ve notlar doğrulanmış argümanlara
43
- // sembol anahtarla takılır.
44
- if (platform) {
45
- const validator = server;
46
- const validate = validator.validateToolInput.bind(server);
47
- validator.validateToolInput = async (tool, args, name) => {
48
- try {
49
- const loaded = await loadBodyFile(name, args, platform.config);
50
- const requiredBody = requiredBodies.get(name);
51
- if (requiredBody && loaded.args?.[requiredBody] === undefined) {
52
- throw new PlatformApiError(`${name}: '${requiredBody}' zorunlu — satır içinde ya da bodyFile ile (.json dosyası) verin. İstek gönderilmedi.`, 400);
53
- }
54
- const { args: aliased, applied } = await applyArgumentAliases(name, loaded.args, { platform, shape: tool.inputSchema?.shape ?? {} });
55
- const parsed = await validate(tool, aliased, name);
56
- const notes = { aliasesApplied: applied, ...(loaded.note ? { bodyFile: loaded.note } : {}) };
57
- return (applied.length > 0 || loaded.note) && parsed && typeof parsed === 'object' ? Object.assign(parsed, { [ARGUMENT_NOTES]: notes }) : parsed;
58
- }
59
- catch (error) {
60
- // Doğrulamadan önceki çeviri (dosya, takma ad) `handle`'ın dışında koşar: hata burada günlüğe yazılır.
61
- if (error instanceof PlatformApiError)
62
- logError(error);
63
- throw error;
64
- }
65
- };
66
- }
67
30
  server.registerTool = ((name, config, callback) => {
68
31
  if (!isRawShape(config.inputSchema))
69
32
  return registerTool(name, config, callback);
70
- // Tanılama notları her tool'da compact döner (g-08: okuma ve çalıştırma yanıtında da 8 not +
71
- // "N not daha"). `diagnostics` parametresi yalnız kayıt yazan tool'lara, microservice_execute'a ve
72
- // *_preview'a açılır — ötekilerde tool listesini büyütmesin diye varsayılan kullanılır. Parametre
73
- // handler'a ULAŞMAZ (gövdeyi `...rest` ile platforma geçiren tool'larda sızardı), yalnız
74
- // toolResult'ın okuduğu bağlama konur.
75
- const writesRecords = config.annotations?.readOnlyHint === false && config.annotations.destructiveHint !== true && !NON_WRITING_TOOLS.has(name);
76
- const exposesDiagnostics = writesRecords || name === 'microservice_execute' || name.endsWith('_preview');
77
- const bodyArgument = BODY_FILE_ARGUMENTS[name];
78
- const bodySchema = bodyArgument ? config.inputSchema[bodyArgument] : undefined;
79
- if (bodyArgument && bodySchema && !bodySchema.isOptional())
80
- requiredBodies.set(name, bodyArgument);
81
- const shape = {
82
- ...config.inputSchema,
83
- ...(bodyArgument && bodySchema ? { [bodyArgument]: bodySchema.optional(), bodyFile: bodyFileParam(bodyArgument) } : {}),
84
- ...(exposesDiagnostics ? { diagnostics: diagnosticsParam } : {})
85
- };
86
- const invoke = (args, extra) => {
87
- const { diagnostics, ...rest } = exposesDiagnostics ? args ?? {} : { ...args, diagnostics: undefined };
88
- return runWithDiagnostics(diagnostics === 'full' ? 'full' : 'compact', () => callback(exposesDiagnostics ? rest : args, extra), exposesDiagnostics);
89
- };
90
- const run = (args, extra) => {
91
- const { [ARGUMENT_NOTES]: notes, ...rest } = args ?? {};
92
- return runWithArgumentNotes(notes ?? { aliasesApplied: [] }, () => invoke(rest, extra));
93
- };
33
+ // Yazma tool'ları tanılama kipini alır; parametre handler'a ULAŞMAZ (gövdeyi `...rest` ile
34
+ // platforma geçiren tool'larda sızardı), yalnız toolResult'ın okuduğu bağlama konur.
35
+ const writesDiagnostics = config.annotations?.readOnlyHint === false && config.annotations.destructiveHint !== true && !NON_WRITING_TOOLS.has(name);
36
+ const shape = writesDiagnostics ? { ...config.inputSchema, diagnostics: diagnosticsParam } : config.inputSchema;
37
+ const run = writesDiagnostics
38
+ ? ((args, extra) => {
39
+ const { diagnostics, ...rest } = args ?? {};
40
+ return runWithDiagnostics(diagnostics === 'full' ? 'full' : 'compact', () => callback(rest, extra));
41
+ })
42
+ : callback;
94
43
  const accepted = Object.keys(shape).join(', ');
95
- const suggestions = (keys) => keys
96
- .map(key => ({ key, near: closestArgument(key, Object.keys(shape)) }))
97
- .filter(entry => entry.near !== undefined)
98
- .map(entry => ` '${entry.key}' → '${entry.near}' mi demek istediniz?`)
99
- .join('');
100
44
  const inputSchema = z.object(shape, {
101
45
  errorMap: (issue, context) => issue.code === 'unrecognized_keys'
102
- ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.${suggestions(issue.keys)}` }
46
+ ? { message: `${name} şu üst düzey argümanları tanımıyor: ${issue.keys.map(key => `'${key}'`).join(', ')}. Tanınmayan alan sessizce yok sayılmaz — çağrı hiç gönderilmedi. Bu tool'un okuduğu alanlar: ${accepted}.` }
103
47
  : { message: context.defaultError }
104
48
  }).strict();
105
49
  return registerTool(name, { ...config, inputSchema }, run);
@@ -1,8 +1,5 @@
1
1
  import { PlatformApiError } from './errors.js';
2
2
  import { randomBytes } from 'node:crypto';
3
- import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
4
- import { dirname, join } from 'node:path';
5
- import { logStep } from '../observability/trace.js';
6
3
  /**
7
4
  * `page_screenshot`/`page_runtime_get` açıklaması "jetonu uygulamanın kendi giriş ucundan alın
8
5
  * (`microservice_execute`)" diyor, ama gizli alan maskesi `access_token`'ı `***` yapıyor ve o yol
@@ -12,19 +9,10 @@ import { logStep } from '../observability/trace.js';
12
9
  * Kasa bu çelişkiyi jetonu bağlama HİÇ sokmadan çözer: maskelenen JWT gateway sürecinde tutulur,
13
10
  * yanıta yalnız kısa ömürlü bir referans (`tok_…`) döner ve kimlik isteyen tool'lar referansı
14
11
  * çözer. Jeton ne yanıtta ne günlükte açık görünür.
15
- *
16
- * g-09 (`plans/mobil-plantcare-acigi`, K9): kasa süreç sınırını aşar. `.env` `MCP_STATE_DIR`
17
- * verilmişse kayıtlar `token-vault.json`'a (0600) yazılır ve süreç açılışta onu okur; süre
18
- * `MCP_TOKEN_TTL_MINUTES`'tan gelir (verilmezse eski 15 dk). Dosya YALNIZ lokal hedefte yazılır —
19
- * uzak bir org'un jetonu diske inmez. Test kullanıcısının (`asUser: 'test:<ad>'`) jetonu da burada,
20
- * etiketiyle tutulur; aynı kullanıcı TTL boyunca yeniden giriş yapmaz.
21
12
  */
22
- const legacyTtlMinutes = 15;
13
+ const ttlMs = 15 * 60 * 1000;
23
14
  const maxEntries = 64;
24
15
  const vault = new Map();
25
- let ttlMs = legacyTtlMinutes * 60 * 1000;
26
- let vaultFile;
27
- let warnedRemote = false;
28
16
  export const tokenRefPattern = /^tok_[0-9a-f]{16}$/;
29
17
  /** Üç base64url parçalı JWT — parola ya da API anahtarı bu şekle uymaz. */
30
18
  export function looksLikeJwt(value) {
@@ -42,132 +30,29 @@ function sweep(now) {
42
30
  vault.delete(oldest.value);
43
31
  }
44
32
  }
45
- function isLocalTarget(baseUrl) {
46
- try {
47
- const host = new URL(baseUrl).hostname;
48
- return host === 'localhost' || host === '127.0.0.1' || host === '[::1]' || host.endsWith('.localhost');
49
- }
50
- catch {
51
- return false;
52
- }
53
- }
54
- /**
55
- * Aynı dosyayı birden çok gateway süreci paylaşır (her Claude Code oturumu kendi stdio sürecini açar).
56
- * Yazma "son yazan kazanır" olursa bir sürecin kaydı ötekinin yazmasıyla silinirdi: yazmadan önce ve
57
- * bellekte olmayan referans istenince dosya okunur, süresi dolmamış yabancı kayıtlar belleğe katılır.
58
- */
59
- function mergeFromFile() {
60
- if (!vaultFile)
61
- return;
62
- try {
63
- const stored = JSON.parse(readFileSync(vaultFile, 'utf8'));
64
- const now = Date.now();
65
- for (const [ref, entry] of Object.entries(stored.entries ?? {})) {
66
- if (!vault.has(ref) && tokenRefPattern.test(ref) && typeof entry.token === 'string' && typeof entry.expires === 'number' && entry.expires > now) {
67
- vault.set(ref, { token: entry.token, expires: entry.expires, ...(typeof entry.label === 'string' ? { label: entry.label } : {}) });
68
- }
69
- }
70
- }
71
- catch {
72
- // dosya yok ya da okunamadı: bellekteki kasa geçerli
73
- }
74
- }
75
- function persist() {
76
- if (!vaultFile)
77
- return;
78
- mergeFromFile();
79
- sweep(Date.now());
80
- try {
81
- const temporary = `${vaultFile}.${process.pid}.tmp`;
82
- mkdirSync(dirname(vaultFile), { recursive: true, mode: 0o700 });
83
- writeFileSync(temporary, JSON.stringify({ entries: Object.fromEntries(vault) }), { mode: 0o600 });
84
- renameSync(temporary, vaultFile);
85
- }
86
- catch (error) {
87
- logStep('jeton kasası ✕', `kasa dosyası yazılamadı (${vaultFile}) — jetonlar bu süreçte bellekte kalır`, [error instanceof Error ? error.message : String(error)]);
88
- }
89
- }
90
- /**
91
- * Süreç açılışında bir kez çağrılır (`index.ts`); testler yeniden başlamayı `clearTokenVault` +
92
- * bu çağrıyla benzetir. Dosyadaki süresi dolmuş kayıtlar yüklenmez ve dosya onlarsız yeniden yazılır.
93
- */
94
- export function configureTokenVault(config) {
95
- ttlMs = (config.tokenTtlMinutes ?? legacyTtlMinutes) * 60 * 1000;
96
- vaultFile = undefined;
97
- if (!config.stateDirectory)
98
- return;
99
- if (!isLocalTarget(config.orgApiBaseUrl)) {
100
- if (!warnedRemote) {
101
- warnedRemote = true;
102
- logStep('jeton kasası', `ORG_API_BASE_URL lokal değil — kasa dosyaya YAZILMAZ, jetonlar yalnız süreç belleğinde tutulur (MCP_STATE_DIR yok sayıldı)`);
103
- }
104
- return;
105
- }
106
- vaultFile = join(config.stateDirectory, 'token-vault.json');
107
- persist();
108
- }
109
- /** Kasanın geçerli ömrü (dakika) — yanıt notları sabit bir süre yazmasın. */
110
- export const tokenTtlMinutes = () => Math.round(ttlMs / 60000);
111
- export function rememberToken(token, label) {
33
+ export function rememberToken(token) {
112
34
  const now = Date.now();
113
35
  sweep(now);
114
36
  for (const [ref, entry] of vault) {
115
37
  if (entry.token === token) {
116
38
  entry.expires = now + ttlMs;
117
- if (label !== undefined)
118
- entry.label = label;
119
- persist();
120
39
  return ref;
121
40
  }
122
41
  }
123
42
  const ref = `tok_${randomBytes(8).toString('hex')}`;
124
- vault.set(ref, { token, expires: now + ttlMs, ...(label !== undefined ? { label } : {}) });
125
- persist();
43
+ vault.set(ref, { token, expires: now + ttlMs });
126
44
  return ref;
127
45
  }
128
46
  export function resolveToken(reference) {
129
- if (!vault.has(reference))
130
- mergeFromFile();
131
47
  const entry = vault.get(reference);
132
48
  if (!entry)
133
49
  return undefined;
134
50
  if (entry.expires <= Date.now()) {
135
51
  vault.delete(reference);
136
- persist();
137
52
  return undefined;
138
53
  }
139
54
  return entry.token;
140
55
  }
141
- /**
142
- * Jetonun kendi süresi (`exp`) kasanın TTL'inden kısa olabilir: uygulamanın jetonu 15 dk yaşarken kasa
143
- * 60 dk tutuyordu ve süresi dolmuş jetonla çekilen kare sessizce çıkış yapmış sayfayı gösterirdi.
144
- * 30 sn pay bırakılır; `exp` okunamayan jeton geçerli sayılır (karar uygulamanındır).
145
- */
146
- const jwtExpired = (token) => {
147
- try {
148
- const payload = JSON.parse(Buffer.from(token.split('.')[1] ?? '', 'base64url').toString('utf8'));
149
- return typeof payload.exp === 'number' && payload.exp * 1000 <= Date.now() + 30_000;
150
- }
151
- catch {
152
- return false;
153
- }
154
- };
155
- function labeledToken(label) {
156
- const find = () => {
157
- const now = Date.now();
158
- for (const entry of vault.values()) {
159
- if (entry.label === label && entry.expires > now && !jwtExpired(entry.token))
160
- return entry.token;
161
- }
162
- return undefined;
163
- };
164
- const found = find();
165
- if (found || !vaultFile)
166
- return found;
167
- mergeFromFile();
168
- return find();
169
- }
170
- /** Bellekteki kasayı boşaltır (süreç yeniden başlamasının benzetimi); dosyaya dokunmaz. */
171
56
  export function clearTokenVault() {
172
57
  vault.clear();
173
58
  }
@@ -181,76 +66,8 @@ export function resolveIdentityToken(value) {
181
66
  return value;
182
67
  const token = resolveToken(value);
183
68
  if (token === undefined) {
184
- throw new PlatformApiError(`'${value}' referansı geçersiz ya da süresi dolmuş (${Math.round(ttlMs / 60000)} dk). Tercih edilen yol asUser: 'test:<ad>' — gateway kök .env'deki test kullanıcısıyla kendisi giriş yapar. Yoksa uygulamanın giriş ucunu microservice_execute ile yeniden çağırıp yanıttaki tokenRefs değerini kullanın.`, 400);
185
- }
186
- return token;
187
- }
188
- /**
189
- * Giriş yanıtındaki erişim jetonu: yanıt birden çok JWT taşıyabilir (erişim + yenileme). Anahtarı
190
- * `access` içeren önce, sonra `refresh` içermeyen, en son ilk bulunan — yenileme jetonuyla istek atmak
191
- * her uçta 401 demekti.
192
- */
193
- function accessJwt(value) {
194
- const found = [];
195
- const collect = (node, key, depth) => {
196
- if (depth > 12)
197
- return;
198
- if (looksLikeJwt(node)) {
199
- found.push({ key, token: node });
200
- return;
201
- }
202
- if (Array.isArray(node))
203
- node.forEach(entry => collect(entry, key, depth + 1));
204
- else if (node && typeof node === 'object')
205
- Object.entries(node).forEach(([name, entry]) => collect(entry, name, depth + 1));
206
- };
207
- collect(value, '', 0);
208
- return (found.find(entry => /access/i.test(entry.key)) ?? found.find(entry => !/refresh/i.test(entry.key)) ?? found[0])?.token;
209
- }
210
- /**
211
- * g-09: `asUser` üç şekil alır — ham JWT, `tok_…` referansı ve `test:<ad>`. Üçüncüsünde gateway kök
212
- * `.env`'deki `MCP_TEST_USER_<AD>` satırının tarif ettiği giriş ucunu (uygulamanın kendi uç'u)
213
- * anonim çağırır, yanıttaki ilk JWT'yi kasaya etiketiyle koyar ve TTL boyunca yeniden kullanır.
214
- * Parola ne yanıta, ne günlüğe (`hideRequestBody`), ne hata metnine girer; satırın değeri hiçbir
215
- * mesajda gösterilmez. AI `.env`'i düzenlemez: tanımsız kullanıcı, insanın ekleyeceği değişkenin
216
- * adıyla reddedilir.
217
- */
218
- export async function resolveIdentity(value, platform, project, environment) {
219
- if (value === undefined || !value.startsWith('test:'))
220
- return resolveIdentityToken(value);
221
- const name = value.slice('test:'.length).trim().toLowerCase();
222
- const variable = `MCP_TEST_USER_${name.toUpperCase()}`;
223
- const label = `test:${name}@${platform.resolveProject(project)}/${environment ?? platform.config.defaultEnvironment}`;
224
- const cached = labeledToken(label);
225
- if (cached)
226
- return cached;
227
- const raw = platform.config.testUsers[name];
228
- if (!raw) {
229
- const defined = Object.keys(platform.config.testUsers);
230
- throw new PlatformApiError(`Test kullanıcısı '${name}' tanımlı değil. Kök .env'e insan ekler: ${variable}={"application":"<uygulama slug>","microservice":"<giriş ucu slug>","body":{…giriş gövdesi…}} (biçim: docs/ortam.md §Test kullanıcıları); gateway yeniden başlatılır. AI .env'i düzenlemez. Tanımlı olanlar: ${defined.length > 0 ? defined.join(', ') : '(yok)'}.`, 400);
231
- }
232
- let login;
233
- try {
234
- login = JSON.parse(raw);
235
- }
236
- catch {
237
- throw new PlatformApiError(`${variable} JSON olarak okunamadı (değer gösterilmez). Biçim: {"application":"…","microservice":"…","body":{…}} — docs/ortam.md §Test kullanıcıları.`, 400);
238
- }
239
- if (typeof login.application !== 'string' || typeof login.microservice !== 'string') {
240
- throw new PlatformApiError(`${variable} 'application' ve 'microservice' alanlarını taşımalı (değer gösterilmez) — docs/ortam.md §Test kullanıcıları.`, 400);
241
- }
242
- const endpoint = `${login.application}/${login.microservice}`;
243
- const response = await platform.tenantRaw(typeof login.method === 'string' ? login.method : 'POST', project, `/m/${endpoint}`, {
244
- environment,
245
- body: login.body,
246
- anonymous: true,
247
- hideRequestBody: true
248
- });
249
- const token = accessJwt(response.body);
250
- if (!token) {
251
- throw new PlatformApiError(`Test kullanıcısı '${name}' girişi jeton döndürmedi: ${endpoint} HTTP ${response.httpStatus}. Kök .env'deki ${variable} satırını (uç ve gövde) ve kullanıcının uygulamada var olduğunu kontrol edin; gövde ve kimlik bilgisi gösterilmez.`, 400);
69
+ throw new PlatformApiError(`'${value}' referansı geçersiz ya da süresi dolmuş (15 dk). Uygulamanın giriş ucunu microservice_execute ile yeniden çağırıp yanıttaki tokenRefs değerini kullanın.`, 400);
252
70
  }
253
- rememberToken(token, label);
254
71
  return token;
255
72
  }
256
73
  /**