genexus-mcp 2.50.0 → 2.52.0

package/cli/lib/client-adapters.js

@@ -0,0 +1,189 @@
+const fs = require('fs');
+
+class BaseClientAdapter {
+    apply(_client, _launcher, _targetConfigPath, _opts = {}) {
+        throw new Error('apply() must be implemented by subclass');
+    }
+    remove(_client, _opts = {}) {
+        throw new Error('remove() must be implemented by subclass');
+    }
+    read(_client, _serverName) {
+        throw new Error('read() must be implemented by subclass');
+    }
+}
+
+class McpServersJsonAdapter extends BaseClientAdapter {
+    constructor(configModule) {
+        super();
+        this.config = configModule || require('./config');
+    }
+    apply(client, launcher, targetConfigPath, opts = {}) {
+        return this.config.applyMcpServersJson(client.path, launcher, targetConfigPath, opts);
+    }
+    remove(client, opts = {}) {
+        return this.config.removeMcpServersJson(client.path, opts);
+    }
+    read(client, serverName) {
+        if (!fs.existsSync(client.path)) return null;
+        const parsed = this.config.readJsonFileSafe(client.path);
+        if (!parsed || typeof parsed !== 'object') return null;
+        let entry = parsed.mcpServers && parsed.mcpServers[serverName];
+        if (!entry && serverName === 'genexus18mcp') {
+            const legacyGx = parsed.mcpServers && parsed.mcpServers.genexus;
+            if (legacyGx && !this.config.isThirdPartyMcpEntry(legacyGx)) entry = legacyGx;
+            else if (parsed.mcpServers && parsed.mcpServers.genexus18) entry = parsed.mcpServers.genexus18;
+        }
+        if (!entry) return null;
+        return {
+            command: entry.command,
+            args: Array.isArray(entry.args) ? entry.args : [],
+            env: (entry.env && typeof entry.env === 'object') ? entry.env : {}
+        };
+    }
+}
+
+class VsCodeServersAdapter extends BaseClientAdapter {
+    constructor(configModule) {
+        super();
+        this.config = configModule || require('./config');
+    }
+    apply(client, launcher, targetConfigPath, opts = {}) {
+        return this.config.applyVsCodeServersJson(client.path, launcher, targetConfigPath, opts);
+    }
+    remove(client, opts = {}) {
+        return this.config.removeVsCodeServersJson(client.path, opts);
+    }
+    read(client, serverName) {
+        if (!fs.existsSync(client.path)) return null;
+        const parsed = this.config.readJsonFileSafe(client.path);
+        if (!parsed || typeof parsed !== 'object') return null;
+        let entry = parsed.servers && parsed.servers[serverName];
+        if (!entry && serverName === 'genexus18mcp') {
+            const legacyGx = parsed.servers && parsed.servers.genexus;
+            if (legacyGx && !this.config.isThirdPartyMcpEntry(legacyGx)) entry = legacyGx;
+            else if (parsed.servers && parsed.servers.genexus18) entry = parsed.servers.genexus18;
+        }
+        if (!entry) return null;
+        return {
+            command: entry.command,
+            args: Array.isArray(entry.args) ? entry.args : [],
+            env: (entry.env && typeof entry.env === 'object') ? entry.env : {}
+        };
+    }
+}
+
+class OpenCodeJsoncAdapter extends BaseClientAdapter {
+    constructor(configModule) {
+        super();
+        this.config = configModule || require('./config');
+    }
+    apply(client, launcher, targetConfigPath, opts = {}) {
+        return this.config.applyOpenCodeJson(client.path, launcher, targetConfigPath, opts);
+    }
+    remove(client, opts = {}) {
+        return this.config.removeOpenCodeJson(client.path, opts);
+    }
+    read(client, serverName) {
+        if (!fs.existsSync(client.path)) return null;
+        const parsed = this.config.readJsonFileSafe(client.path);
+        if (!parsed || typeof parsed !== 'object' || !parsed.mcp || typeof parsed.mcp !== 'object') return null;
+        const nested = parsed.mcp.servers && typeof parsed.mcp.servers === 'object' && !Array.isArray(parsed.mcp.servers);
+        const container = nested ? parsed.mcp.servers : parsed.mcp;
+        let entry = container[serverName];
+        if (!entry && serverName === 'genexus18mcp') {
+            const legacyGx = container.genexus;
+            if (legacyGx && !this.config.isThirdPartyMcpEntry(legacyGx)) entry = legacyGx;
+            else if (container.genexus18) entry = container.genexus18;
+        }
+        if (!entry) return null;
+        const cmd = Array.isArray(entry.command) ? entry.command[0] : entry.command;
+        const args = Array.isArray(entry.command) ? entry.command.slice(1) : (Array.isArray(entry.args) ? entry.args : []);
+        const env = (entry.environment && typeof entry.environment === 'object') ? entry.environment
+            : ((entry.env && typeof entry.env === 'object') ? entry.env : {});
+        return { command: cmd, args, env };
+    }
+}
+
+class CodexTomlAdapter extends BaseClientAdapter {
+    constructor(configModule) {
+        super();
+        this.config = configModule || require('./config');
+    }
+    apply(client, launcher, targetConfigPath, opts = {}) {
+        return this.config.applyCodexToml(client.path, launcher, targetConfigPath, opts);
+    }
+    remove(client, opts = {}) {
+        return this.config.removeCodexToml(client.path, opts);
+    }
+    read(client, serverName) {
+        if (!fs.existsSync(client.path)) return null;
+        let content = '';
+        try {
+            content = fs.readFileSync(client.path, 'utf8');
+        } catch {
+            return null;
+        }
+        let parsed = this.config.extractCodexTomlEntry(content, serverName);
+        if (!parsed && serverName === 'genexus18mcp') {
+            const legacyGx = this.config.extractCodexTomlEntry(content, 'genexus');
+            if (legacyGx && !this.config.isThirdPartyMcpEntry(legacyGx)) parsed = legacyGx;
+            else {
+                const legacyGx18 = this.config.extractCodexTomlEntry(content, 'genexus18');
+                if (legacyGx18) parsed = legacyGx18;
+            }
+        }
+        if (!parsed) return null;
+        return {
+            command: parsed.command,
+            args: Array.isArray(parsed.args) ? parsed.args : [],
+            env: (parsed.env && typeof parsed.env === 'object') ? parsed.env : {}
+        };
+    }
+}
+
+const adapters = {
+    'mcpServers': new McpServersJsonAdapter(),
+    'vscode-servers': new VsCodeServersAdapter(),
+    'opencode': new OpenCodeJsoncAdapter(),
+    'codex-toml': new CodexTomlAdapter()
+};
+
+function getClientAdapter(format) {
+    const adapter = adapters[format];
+    if (!adapter) {
+        throw new Error(`Unknown client format: ${format}`);
+    }
+    return adapter;
+}
+
+class ClientConfigManager {
+    constructor(configModule) {
+        this.config = configModule || require('./config');
+    }
+
+    apply(client, launcher, targetConfigPath, opts = {}) {
+        const adapter = getClientAdapter(client.format);
+        return adapter.apply(client, launcher, targetConfigPath, opts);
+    }
+
+    remove(client, opts = {}) {
+        const adapter = getClientAdapter(client.format);
+        return adapter.remove(client, opts);
+    }
+
+    read(client, serverName) {
+        if (client.writeSupported === false) return null;
+        const adapter = getClientAdapter(client.format);
+        return adapter.read(client, serverName);
+    }
+}
+
+module.exports = {
+    BaseClientAdapter,
+    McpServersJsonAdapter,
+    VsCodeServersAdapter,
+    OpenCodeJsoncAdapter,
+    CodexTomlAdapter,
+    getClientAdapter,
+    ClientConfigManager
+};

package/cli/lib/client-adapters.test.js

@@ -0,0 +1,50 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const fs = require('node:fs');
+const os = require('node:os');
+const {
+    getClientAdapter,
+    McpServersJsonAdapter,
+    VsCodeServersAdapter,
+    OpenCodeJsoncAdapter,
+    CodexTomlAdapter,
+    ClientConfigManager
+} = require('./client-adapters');
+
+test('getClientAdapter returns correct strategy for each format', () => {
+    assert.ok(getClientAdapter('mcpServers') instanceof McpServersJsonAdapter);
+    assert.ok(getClientAdapter('vscode-servers') instanceof VsCodeServersAdapter);
+    assert.ok(getClientAdapter('opencode') instanceof OpenCodeJsoncAdapter);
+    assert.ok(getClientAdapter('codex-toml') instanceof CodexTomlAdapter);
+});
+
+test('ClientConfigManager applies and reads mcpServers format cleanly', () => {
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'gx-cli-test-'));
+    const configPath = path.join(tmpDir, 'mcp.json');
+    const client = { id: 'test-cursor', name: 'Test Cursor', format: 'mcpServers', path: configPath };
+    const launcher = { command: 'node', args: ['run.js'] };
+
+    try {
+        const manager = new ClientConfigManager();
+        manager.apply(client, launcher, 'C:\\MyKb\\config.json', { serverName: 'genexus18mcp' });
+
+        const raw = fs.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        assert.ok(parsed.mcpServers);
+        assert.ok(parsed.mcpServers.genexus18mcp);
+        assert.equal(parsed.mcpServers.genexus18mcp.command, 'node');
+
+        const readEntry = manager.read(client, 'genexus18mcp');
+        assert.ok(readEntry);
+        assert.equal(readEntry.command, 'node');
+
+        const wasRemoved = manager.remove(client, { serverName: 'genexus18mcp' });
+        assert.equal(wasRemoved, true);
+
+        const afterRemove = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        assert.equal(afterRemove.mcpServers.genexus18mcp, undefined);
+    } finally {
+        try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { }
+    }
+});

package/cli/lib/config.js

@@ -861,33 +861,13 @@ function unpatchClientConfig(opts = {}) {
 }
 
 function applyClientEntry(client, launcher, targetConfigPath, opts = {}) {
-    switch (client.format) {
-        case 'mcpServers':
-            return applyMcpServersJson(client.path, launcher, targetConfigPath, opts);
-        case 'opencode':
-            return applyOpenCodeJson(client.path, launcher, targetConfigPath, opts);
-        case 'codex-toml':
-            return applyCodexToml(client.path, launcher, targetConfigPath, opts);
-        case 'vscode-servers':
-            return applyVsCodeServersJson(client.path, launcher, targetConfigPath, opts);
-        default:
-            throw new Error(`Unknown client format: ${client.format}`);
-    }
+    const { getClientAdapter } = require('./client-adapters');
+    return getClientAdapter(client.format).apply(client, launcher, targetConfigPath, opts);
 }
 
 function removeClientEntry(client, opts = {}) {
-    switch (client.format) {
-        case 'mcpServers':
-            return removeMcpServersJson(client.path, opts);
-        case 'opencode':
-            return removeOpenCodeJson(client.path, opts);
-        case 'codex-toml':
-            return removeCodexToml(client.path, opts);
-        case 'vscode-servers':
-            return removeVsCodeServersJson(client.path, opts);
-        default:
-            throw new Error(`Unknown client format: ${client.format}`);
-    }
+    const { getClientAdapter } = require('./client-adapters');
+    return getClientAdapter(client.format).remove(client, opts);
 }
 
 function applyMcpServersJson(filePath, launcher, targetConfigPath, { serverName = DEFAULT_MCP_SERVER_NAME, force = false } = {}) {
@@ -1534,5 +1514,17 @@ module.exports = {
     getLauncher,
     readClientCommandEntry,
     isOurMcpEntry,
-    DEFAULT_MCP_SERVER_NAME
+    DEFAULT_MCP_SERVER_NAME,
+    applyMcpServersJson,
+    removeMcpServersJson,
+    applyVsCodeServersJson,
+    removeVsCodeServersJson,
+    applyOpenCodeJson,
+    removeOpenCodeJson,
+    applyCodexToml,
+    removeCodexToml,
+    extractCodexTomlEntry,
+    isThirdPartyMcpEntry,
+    applyClientEntry,
+    removeClientEntry
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "2.50.0",
+  "version": "2.52.0",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 18 MCP server — read, edit, and analyze GeneXus knowledge base objects (transactions, web panels, procedures, SDTs) directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [
@@ -30,7 +30,7 @@
     "automation"
   ],
   "scripts": {
-    "test": "node --test cli/run.test.js",
+    "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js",
     "lint": "eslint cli scripts eslint.config.js --max-warnings=0",
     "test:one": "node scripts/test-one.js",
     "prepack": "node scripts/clean-package.js",

package/publish/GxMcp.Gateway.deps.json

@@ -7,7 +7,7 @@
   "targets": {
     ".NETCoreApp,Version=v8.0": {},
     ".NETCoreApp,Version=v8.0/win-x64": {
-      "GxMcp.Gateway/2.50.0": {
+      "GxMcp.Gateway/2.52.0": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -66,7 +66,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/2.50.0": {
+    "GxMcp.Gateway/2.52.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/publish/config.json

@@ -1,17 +1,17 @@
 {
+  "Environment": {
+    "KBPath": "C:\\\\KBs\\\\YourKB"
+  },
   "Logging": {
     "Level": "Debug",
     "Path": "logs"
   },
   "Server": {
-    "McpStdio": true,
-    "HttpPort": 5000
+    "HttpPort": 5000,
+    "McpStdio": true
   },
   "GeneXus": {
     "WorkerExecutable": "C:\\Projetos\\Genexus18MCP\\publish\\\\worker\\\\GxMcp.Worker.exe",
     "InstallationPath": "C:\\\\Program Files (x86)\\\\GeneXus\\\\GeneXus18"
-  },
-  "Environment": {
-    "KBPath": "C:\\\\KBs\\\\YourKB"
   }
 }

package/publish/tool_definitions.json

@@ -26,7 +26,7 @@
   {"name":"genexus_search_source","description":"Regex/semantic search across Procedure/DataProvider/WebPanel/Transaction source. Requires the KB index to be Ready — check genexus_lifecycle action=status if results look empty.","inputSchema":{"type":"object","properties":{"callee":{"type":"string","description":"Method/function name (qualified or unqualified)."},"argMatches":{"type":"object","description":"Positional arg index to expected literal text."},"pattern":{"type":"string"},"typeFilter":{"type":"string"},"objectName":{"type":"string","description":"Restrict the scan to these exact object name(s), comma-separated. Makes a search inside one known object O(object) not O(KB), and bypasses the type whitelist."},"startIndex":{"type":"integer","description":"Legacy object-boundary resume. For a page that ended inside an object, prefer the opaque cursor returned in nextCursor."},"cursor":{"type":"string","description":"Opaque continuation token from nextCursor; preferred when a result page ended inside an object. Do not edit."},"timeoutMs":{"type":"integer","description":"Wall-clock budget (default 30000). Raise it to scan more objects per call."},"scope":{"type":"array","items":{"type":"string","enum":["source","rules","conditions","events","webForm","layout"]},"description":"Parts to scan with line-numbered context. Default [source]. webForm/layout scans the WebPanel/Transaction visual XML (control names, captions, classes, bindings)."},"fields":{"type":"array","items":{"type":"string","enum":["source","caption","description","parmNames","webForm"]},"description":"Whole-field metadata match (returns matchedValue, no line context). Default [source]. Prefer scope=[webForm] for line-context WebForm hits; use fields=[webForm] only for a coarse contains-match."},"maxResults":{"type":"integer"},"caseSensitive":{"type":"boolean"},"includeComments":{"type":"boolean"},"inline_read_top":{"type":"integer","description":"0-3. Inline reads of top N distinct objects in response."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"pattern":"ControlType=\"Radio\""},{"pattern":"for each","typeFilter":"Procedure","maxResults":20}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},
   {"name":"genexus_kb","description":"Manage open KBs, startup config, and GeneXus environments. list/open/close/set_default operate on WorkerPool; set_default selects the implicit target for calls that omit kb (an explicit kb always wins for parallel or cross-KB work); set_startup/get_startup mirror IDE 'Set As Startup Object'; list_environments lists all configured environments; get_environment reads the active environment; set_environment selects an environment.","inputSchema":{"type":"object","properties":{"action":{"type":"string","enum":["list","open","close","set_default","set_startup","get_startup","list_environments","get_environment","set_environment"]},"alias":{"type":"string","description":"KB alias. open: auto from path basename if omitted."},"path":{"type":"string","description":"Absolute KB path (required for open if alias not in config)."},"name":{"type":"string","description":"Object name (required for set_startup)."},"environment":{"type":"string","description":"Environment name/folder (required for set_environment), e.g. development."}},"required":["action"],"examples":[{"action":"open","path":"C:\\KBs\\MyKb"},{"action":"list"},{"action":"list_environments"},{"action":"get_environment"},{"action":"set_environment","environment":"development"}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_navigation","description":"View navigation report (IDE Right-click → View Navigation). latest=true returns cached report from .gx/navigation-cache; else runs fresh.","inputSchema":{"type":"object","required":["action","name"],"properties":{"action":{"type":"string","enum":["view"]},"name":{"type":"string"},"latest":{"type":"boolean","default":false,"description":"Return the most recent cached navigation if any; otherwise run fresh."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"view","name":"Customer"},{"action":"view","name":"Customer","latest":true}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},
-  {"name":"genexus_api","description":"Introspect REST endpoints exposed by HTTP procedures. action=list|describe|snapshot|diff_baseline. Returns endpoints + detects breaking changes vs a saved baseline.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["list","describe","snapshot","diff_baseline"]},"target":{"type":"string","description":"Procedure name (action=describe)."},"name":{"type":"string","description":"Baseline name (action=snapshot)."},"baseline":{"type":"string","description":"Baseline name under .gx/api-baselines/ or absolute path (action=diff_baseline)."},"pathPrefix":{"type":"string","description":"Folder prefix filter (action=list), e.g. 'Root Module/API/'."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"list"},{"action":"describe","target":"ApiCustomerGet"}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
+  {"name":"genexus_api","description":"Inspect HTTP procedures and native API routes. action=list|describe|routes_inspect|routes_clone|routes_update|snapshot|diff_baseline. API route writes use typed ServiceGroupSource, optimistic versioning, full snapshot, rollback and post-save reread; no lifecycle operation is implicit.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["list","describe","routes_inspect","routes_clone","routes_update","snapshot","diff_baseline"]},"api":{"type":"string","description":"API name (routes_inspect|routes_clone|routes_update)."},"sourcePrefix":{"type":"string","description":"Source method/path prefix, e.g. inbound."},"targetPrefix":{"type":"string","description":"Target method/path prefix, e.g. reverse."},"expectedVersion":{"type":"string","description":"versionToken returned by the preceding dry run or inspection."},"dryRun":{"type":"boolean","default":true,"description":"routes_clone/routes_update: preview first; false writes only with expectedVersion."},"rollbackOnFailure":{"type":"boolean","default":true,"description":"Restore the complete API snapshot when post-save verification diverges."},"operation":{"type":"string","description":"Operation value carried by the reused request contract, e.g. REVERSE."},"target":{"type":"string","description":"Procedure or API name (action=describe)."},"name":{"type":"string","description":"Baseline name (action=snapshot)."},"baseline":{"type":"string","description":"Baseline name under .gx/api-baselines/ or absolute path (action=diff_baseline)."},"pathPrefix":{"type":"string","description":"Folder prefix filter (action=list)."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"list"},{"action":"routes_inspect","api":"OrdersApi"},{"action":"routes_clone","api":"OrdersApi","sourcePrefix":"inbound","targetPrefix":"reverse","operation":"REVERSE","dryRun":true,"rollbackOnFailure":true}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_apply_pattern","description":"Apply a pattern (e.g. WorkWithPlus) to a parent (IDE Right-click → Apply Pattern). Transaction=family-gen; WebPanel/WebComponent/SDPanel=direct-attach (pass settings.template). mode=diagnose (or dryRun=true) returns findings without mutating. Working on Smart Devices? → resources/read uri=genexus://kb/skills/sd-panel-mobile for Main object semantics. mode=actions manages typed grid actions and Action Groups, persists and re-reads PatternInstance, supports dryRun diff, and never adds security permissions automatically.","inputSchema":{"type":"object","required":["name","pattern"],"properties":{"name":{"type":"string","description":"Target KBObject name."},"pattern":{"type":"string","description":"Pattern key ('WorkWithPlus') or GUID."},"mode":{"type":"string","enum":["apply","diagnose","actions"],"description":"apply (default) mutates; diagnose returns reasons without applying. actions exposes typed WWP action-group editing."},"action":{"type":"string","enum":["list_actions","add_grid_action","update_action","move_action","remove_action"],"description":"mode=actions operation."},"group":{"type":"string"},"actionName":{"type":"string"},"newGroup":{"type":"string"},"position":{"type":"integer","minimum":0},"procedure":{"type":"string"},"selection":{"type":"string","enum":["current","multiple"]},"enabledWhen":{"type":"string"},"visibleWhen":{"type":"string"},"icon":{"type":"string"},"description":{"type":"string"},"confirmation":{"type":"string"},"confirmTitle":{"type":"string"},"settings":{"type":"object","description":"Pattern-instance settings tree."},"reapply":{"type":"boolean","default":false,"description":"Re-run on existing instance."},"validate":{"type":"boolean","default":false,"description":"After apply, build the generated host. Adds validation block (60-180s). Catches binding errors."},"dryRun":{"type":"boolean","default":false,"description":"Alias for mode=diagnose. When true, returns pattern findings without mutating. With mode=actions it previews the typed action diff."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"name":"Customer","pattern":"WorkWithPlus"},{"name":"Customer","pattern":"WorkWithPlus","mode":"diagnose"},{"name":"Customer","pattern":"WorkWithPlus","mode":"actions","action":"add_grid_action","group":"Actions","actionName":"Approve","procedure":"ApproveCustomer","dryRun":true}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_edit_and_build","description":"Edit + rebuild callers in one call. Returns edit diff + impact + a build block that may include taskId/pollTarget for lifecycle follow-up. validate=true/validationMode=specify validates the saved object; rollbackOnFailure restores its pre-write snapshot on specification failure.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"Target object name."},"part":{"type":"string","description":"Part (Source, Rules, ...)."},"content":{"type":"string","description":"New content. For mode=patch may be {find,replace} object."},"patch":{"description":"Same shape as genexus_edit.patch. Auto-sets mode=patch."},"mode":{"type":"string","enum":["full","patch"],"default":"patch"},"type":{"type":"string","description":"Disambiguates ambiguous names."},"dryRun":{"type":"boolean","default":false},"validate":{"type":"boolean","default":false},"validationMode":{"type":"string","enum":["specify"],"default":"specify"},"rollbackOnFailure":{"type":"boolean","default":true},"buildIncludeCallees":{"type":"string","enum":["none","direct","transitive"],"default":"direct"},"buildPlanCap":{"type":"integer","default":200},"waitForIndex":{"type":"boolean","default":true},"waitTimeoutMs":{"type":"integer","default":30000},"visualVerify":{"type":"boolean","default":false,"description":"Post-edit headless screenshot + pixel-diff vs baseline. See tool-help."}},"required":["name","part"],"examples":[{"name":"Customer","part":"Source","patch":{"find":"oldValue","replace":"newValue"},"validate":true},{"name":"Customer","part":"Rules","mode":"patch","patch":{"find":"error(","replace":"msg("},"dryRun":true}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_security","description":"Audit KB security. action=audit_gam scans GAM/env props; action=scan_secrets greps Source for credential-shaped literals. Returns findings with severity.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["audit_gam","scan_secrets","scan_native"]},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"audit_gam"},{"action":"scan_secrets"}]},"annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},