genexus-mcp 3.4.2 → 3.5.0

package/cli/commands/axi.js

@@ -1522,7 +1522,8 @@ async function runInteractiveInit(ctx) {
                 meta: {
                     patchedClients: patchResult.patched,
                     failedClients: patchResult.failed,
-                    skippedClients: patchResult.skipped || []
+                    skippedClients: patchResult.skipped || [],
+                    verifiedClients: patchResult.verified || []
                 }
             }
         };
@@ -1844,6 +1845,7 @@ async function handleInit(options, ctx) {
                     patchedClients: patchResult.patched,
                     failedClients: patchResult.failed,
                     skippedClients: patchResult.skipped || [],
+                    verifiedClients: patchResult.verified || [],
                     smokeSkipped: !!options.noSmoke,
                     warmed: !!warm && warm.status === 'pass'
                 }
@@ -2137,9 +2139,25 @@ async function handleClients(subcommand, options, ctx) {
             help.push(`Register installed-but-unregistered agents: genexus-mcp clients add --clients ${installedUnregistered.map((r) => r.id).join(',')}${serverName !== DEFAULT_MCP_SERVER_NAME ? ` --server-name ${serverName}` : ''}`);
         }
         const stale = rows.filter((r) => r.commandStale);
-        if (stale.length > 0) {
-            help.push(`These clients point at a missing gateway exe (will fail to connect) — re-register: genexus-mcp clients add --clients ${stale.map((r) => r.id).join(',')}${serverName !== DEFAULT_MCP_SERVER_NAME ? ` --server-name ${serverName}` : ''}`);
+        const missingLaunchers = stale.filter((r) => r.launcherStructuralState === 'missing');
+        const invalidLaunchers = stale.filter((r) =>
+            r.launcherSemanticState === 'invalid' && r.launcherStructuralState !== 'missing'
+        );
+        if (missingLaunchers.length > 0) {
+            help.push(`These clients point at a missing gateway exe (will fail to connect) — re-register: genexus-mcp clients add --clients ${missingLaunchers.map((r) => r.id).join(',')}${serverName !== DEFAULT_MCP_SERVER_NAME ? ` --server-name ${serverName}` : ''}`);
         }
+        if (invalidLaunchers.length > 0) {
+            help.push(`These clients have a known-invalid MCP launcher (check command and args) — re-register: genexus-mcp clients add --clients ${invalidLaunchers.map((r) => r.id).join(',')}${serverName !== DEFAULT_MCP_SERVER_NAME ? ` --server-name ${serverName}` : ''}`);
+        }
+        const otherStale = stale.filter((r) =>
+            r.launcherStructuralState !== 'missing' && r.launcherSemanticState !== 'invalid'
+        );
+        if (otherStale.length > 0) {
+            help.push(`These clients have a stale launcher — re-register: genexus-mcp clients add --clients ${otherStale.map((r) => r.id).join(',')}${serverName !== DEFAULT_MCP_SERVER_NAME ? ` --server-name ${serverName}` : ''}`);
+        }
+        const semanticValidCount = rows.filter((r) => r.launcherSemanticState === 'valid').length;
+        const semanticInvalidCount = rows.filter((r) => r.launcherSemanticState === 'invalid').length;
+        const semanticUnknownCount = rows.filter((r) => r.launcherSemanticState === 'unknown').length;
         for (const r of rows) {
             if (r.installed && !r.writeSupported && r.note) help.push(`${r.name}: ${r.note}`);
         }
@@ -2148,7 +2166,15 @@ async function handleClients(subcommand, options, ctx) {
             envelope: {
                 ok: {
                     clients: rows,
-                    summary: { total: rows.length, installed: installedCount, registered: registeredCount, serverName }
+                    summary: {
+                        total: rows.length,
+                        installed: installedCount,
+                        registered: registeredCount,
+                        semanticValid: semanticValidCount,
+                        semanticInvalid: semanticInvalidCount,
+                        semanticUnknown: semanticUnknownCount,
+                        serverName
+                    }
                 },
                 help
             }
@@ -2214,7 +2240,11 @@ async function handleClients(subcommand, options, ctx) {
                 envelope: {
                     ok: { action: 'clients.add', configPath, serverName, patchedClients: patch.patched, patchedCount: patch.patched.length },
                     help,
-                    meta: { failedClients: patch.failed, skippedClients: patch.skipped }
+                    meta: {
+                        failedClients: patch.failed,
+                        skippedClients: patch.skipped,
+                        verifiedClients: patch.verified || []
+                    }
                 }
             };
         }

package/cli/lib/config.js

@@ -876,29 +876,217 @@ function listSupportedClientIds() {
     return getClientConfigTargets().map((c) => c.id);
 }
 
-// Judge whether a registered launcher command is healthy. npx/node/genexus-mcp
-// shims resolve at runtime so we can't fault them; any other launcher referenced
-// by an explicit path (a separator in the command) that no longer exists on disk
-// is the classic "Failed to connect / still on old version" cause after an
-// install dir moved or was cleaned — covers .exe, .bat, .cmd, .sh, extensionless.
-function clientCommandHealth(entry, client = null) {
-    if (!entry || !entry.command) return { stale: false, reason: null };
-    const cmd = String(entry.command);
-    if (/(^|[\\/])(npx|npx\.cmd|node|node\.exe|genexus-mcp|genexus-mcp\.cmd)$/i.test(cmd)) {
-        return { stale: false, reason: null };
+// The list command is intentionally local: it does not spawn a configured
+// launcher or perform an MCP handshake. These states keep registration, path
+// presence, and known command semantics separate while retaining commandStale
+// as the actionable compatibility flag for a missing/known-invalid launcher.
+function normalizeLauncherToken(value) {
+    return String(value || '').trim().replace(/^['"]|['"]$/g, '');
+}
+
+function launcherBaseName(command) {
+    const token = normalizeLauncherToken(command);
+    const lastSlash = Math.max(token.lastIndexOf('/'), token.lastIndexOf('\\'));
+    return token.slice(lastSlash + 1).toLowerCase();
+}
+
+function launcherHasExplicitPath(command) {
+    const token = normalizeLauncherToken(command);
+    return token.includes('/') || token.includes('\\');
+}
+
+function hasKnownNpxPackage(args) {
+    return Array.isArray(args) && args.some((arg) =>
+        typeof arg === 'string' && /^genexus-mcp(?:@[^\s]+)?$/i.test(arg.trim())
+    );
+}
+
+function nodeEntrypointInfo(args) {
+    if (!Array.isArray(args) || args.length === 0) return { state: 'missing', value: null };
+
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = typeof args[i] === 'string' ? args[i].trim() : '';
+        if (!arg) continue;
+        if (arg === '--') {
+            return args[i + 1]
+                ? { state: 'entrypoint', value: args[i + 1] }
+                : { state: 'missing', value: null };
+        }
+        if (arg.startsWith('-')) {
+            // Inline/evaluated Node programs may start MCP, but their semantics
+            // cannot be established without executing them. Keep them unknown.
+            if (/^(?:-e|-p|--eval(?:=|$)|--print(?:=|$)|--check(?:=|$))/.test(arg)) {
+                return { state: 'indeterminate', value: null };
+            }
+            continue;
+        }
+        return { state: 'entrypoint', value: arg };
+    }
+
+    return { state: 'missing', value: null };
+}
+
+function isKnownNodeEntrypoint(entrypoint) {
+    const normalized = normalizeLauncherToken(entrypoint).replace(/\\/g, '/').toLowerCase();
+    return normalized === 'cli/run.js' || normalized.endsWith('/cli/run.js');
+}
+
+function clientCommandHealth(entry, client = null, { fs: fileSystem = fs } = {}) {
+    const unknown = {
+        stale: false,
+        reason: null,
+        structuralState: 'indeterminate',
+        semanticState: 'unknown',
+        semanticReason: null
+    };
+    const invalid = (reason, structuralState = 'present') => ({
+        stale: true,
+        reason,
+        structuralState,
+        semanticState: 'invalid',
+        semanticReason: reason
+    });
+    const valid = (structuralState = 'present') => ({
+        stale: false,
+        reason: null,
+        structuralState,
+        semanticState: 'valid',
+        semanticReason: null
+    });
+    const missingLauncherReason = 'configured launcher does not exist on disk';
+
+    if (entry === null || entry === undefined) {
+        return {
+            stale: false,
+            reason: null,
+            structuralState: 'not-registered',
+            semanticState: 'not-applicable',
+            semanticReason: null
+        };
+    }
+    if (typeof entry !== 'object') {
+        return invalid('configured local MCP entry has no command or URL', 'invalid');
+    }
+    if (entry.url || entry.type === 'http' || entry.type === 'sse' || entry.type === 'remote') {
+        return {
+            stale: false,
+            reason: null,
+            structuralState: 'not-applicable',
+            semanticState: 'not-applicable',
+            semanticReason: null
+        };
+    }
+
+    const command = normalizeLauncherToken(entry.command);
+    if (!command) return invalid('configured local MCP entry has no command', 'invalid');
+
+    const args = Array.isArray(entry.args) ? entry.args : [];
+    const baseName = launcherBaseName(command);
+    const explicitPath = launcherHasExplicitPath(command);
+    const exists = explicitPath ? fileSystem.existsSync(command) : null;
+    const knownRuntimeLauncher = baseName === 'npx'
+        || baseName === 'npx.cmd'
+        || baseName === 'node'
+        || baseName === 'node.exe'
+        || baseName === 'genexus-mcp'
+        || baseName === 'genexus-mcp.cmd'
+        || baseName === 'start_mcp.bat'
+        || baseName === 'gxmcp.gateway.exe';
+    const structuralState = explicitPath
+        ? (exists ? 'present' : 'missing')
+        : (knownRuntimeLauncher ? 'present' : 'indeterminate');
+
+    if (baseName === 'gxmcp.gateway.exe') {
+        if (!explicitPath) {
+            return {
+                ...unknown,
+                semanticReason: 'direct Gateway launcher must use an explicit path that can be checked locally'
+            };
+        }
+        if (!exists) return invalid(missingLauncherReason, 'missing');
+        if (client && client.preferDirectGateway) {
+            const currentPackageGateway = getGatewayExePath();
+            if (fs.existsSync(currentPackageGateway) && normalizeExePath(command) !== normalizeExePath(currentPackageGateway)) {
+                return {
+                    ...valid('present'),
+                    stale: true,
+                    reason: 'configured launcher points at a different package gateway; re-register the client'
+                };
+            }
+        }
+        return valid('present');
     }
-    if (/[\\/]/.test(cmd) && !fs.existsSync(cmd)) {
-        return { stale: true, reason: 'configured launcher does not exist on disk' };
+
+    if (baseName === 'npx' || baseName === 'npx.cmd') {
+        if (!exists && explicitPath) return invalid(missingLauncherReason, 'missing');
+        if (hasKnownNpxPackage(args)) return valid(structuralState);
+        if (args.length === 0) {
+            return invalid('npx launcher requires the genexus-mcp package in args (for example -y genexus-mcp@latest)', structuralState);
+        }
+        return {
+            ...unknown,
+            structuralState,
+            semanticReason: 'npx launcher package is not recognized as genexus-mcp'
+        };
     }
-    if (client && client.preferDirectGateway && /GxMcp\.Gateway\.exe$/i.test(cmd)) {
-        const currentPackageGateway = getGatewayExePath();
-        if (fs.existsSync(currentPackageGateway) && normalizeExePath(cmd) !== normalizeExePath(currentPackageGateway)) {
-            return { stale: true, reason: 'configured launcher points at a different package gateway; re-register the client' };
+
+    if (baseName === 'node' || baseName === 'node.exe') {
+        if (!exists && explicitPath) return invalid(missingLauncherReason, 'missing');
+        const entrypoint = nodeEntrypointInfo(args);
+        if (entrypoint.state === 'missing') {
+            return invalid('node launcher requires a CLI entrypoint in args (for example cli/run.js)', structuralState);
+        }
+        if (entrypoint.state === 'indeterminate') {
+            return {
+                ...unknown,
+                structuralState,
+                semanticReason: 'node launcher uses an evaluated entrypoint that cannot be verified locally'
+            };
+        }
+        if (!isKnownNodeEntrypoint(entrypoint.value)) {
+            return {
+                ...unknown,
+                structuralState,
+                semanticReason: 'node entrypoint is not recognized as the genexus-mcp CLI'
+            };
         }
+        if (!fileSystem.existsSync(normalizeLauncherToken(entrypoint.value))) {
+            return invalid(`configured node entrypoint does not exist on disk: ${entrypoint.value}`, structuralState);
+        }
+        return valid(structuralState);
+    }
+
+    if (baseName === 'genexus-mcp' || baseName === 'genexus-mcp.cmd') {
+        if (!exists && explicitPath) return invalid(missingLauncherReason, 'missing');
+        return valid(structuralState);
+    }
+    if (baseName === 'start_mcp.bat' && explicitPath) {
+        if (!exists) return invalid(missingLauncherReason, 'missing');
+        return valid('present');
     }
-    return { stale: false, reason: null };
-}
 
+    if (explicitPath && !exists) {
+        return {
+            ...unknown,
+            stale: true,
+            reason: missingLauncherReason,
+            structuralState: 'missing',
+            semanticReason: 'launcher command is not recognized locally; run doctor for runtime validation'
+        };
+    }
+    if (explicitPath) {
+        return {
+            ...unknown,
+            structuralState: 'present',
+            semanticReason: 'launcher command is not recognized locally; run doctor for runtime validation'
+        };
+    }
+    return {
+        ...unknown,
+        structuralState,
+        semanticReason: 'launcher command cannot be classified without a known local command shape'
+    };
+}
 function buildManualClientSetup(client, targetConfigPath = null) {
     return {
         mode: 'manual',
@@ -945,7 +1133,11 @@ function clientsStatus(opts = {}) {
             writeSupported: client.writeSupported !== false,
             configPath: client.path,
             command: entry && entry.command ? entry.command : null,
+            args: entry && Array.isArray(entry.args) ? entry.args : [],
             url: entry && entry.url ? entry.url : null,
+            launcherStructuralState: health.structuralState,
+            launcherSemanticState: health.semanticState,
+            launcherSemanticReason: health.semanticReason,
             commandStale: health.stale,
             commandStaleReason: health.reason || (isThirdParty ? 'configured as third-party / HTTP MCP server (e.g. official GeneXus MCP)' : null),
             detectedAt: det.markerHit || (det.hasConfig ? client.path : null),
@@ -1000,6 +1192,7 @@ function patchClientConfig(targetConfigPath, opts = {}) {
     const patched = [];
     const failed = [];
     const skipped = [];
+    const verified = [];
 
     for (const client of candidates) {
         // Detect-only agents can't be auto-written; surface
@@ -1029,24 +1222,38 @@ function patchClientConfig(targetConfigPath, opts = {}) {
         }
         try {
             fileSystem.mkdirSync(path.dirname(client.path), { recursive: true });
-            applyClientEntry(client, getLauncher(client), targetConfigPath, {
+            const launcher = getLauncher(client);
+            applyClientEntry(client, launcher, targetConfigPath, {
                 serverName,
                 force,
                 globalConfig: Boolean(opts.globalConfig),
                 fs: fileSystem
             });
-            // Read-back: confirm the entry is actually present and the file still
-            // parses, so a silently-corrupted write is reported as a failure.
-            if (!readClientCommandEntry(client, serverName, { fs: fileSystem })) {
+            // Read-back: confirm the entry is actually present, the file still
+            // parses, and the generated command is a known valid local launcher.
+            const writtenEntry = readClientCommandEntry(client, serverName, { fs: fileSystem });
+            if (!writtenEntry) {
                 throw new Error(`post-write verification failed (${serverName} entry not found after write)`);
             }
+            const health = clientCommandHealth(writtenEntry, client, { fs: fileSystem });
+            if (health.semanticState !== 'valid') {
+                const reason = health.semanticReason || health.reason || `launcher semantic state is ${health.semanticState}`;
+                throw new Error(`post-write verification failed (${reason})`);
+            }
+            verified.push({
+                client: client.name,
+                command: writtenEntry.command || null,
+                args: Array.isArray(writtenEntry.args) ? writtenEntry.args : [],
+                launcherStructuralState: health.structuralState,
+                launcherSemanticState: health.semanticState
+            });
             patched.push(client.name);
         } catch (err) {
             failed.push({ client: client.name, reason: err && err.message ? err.message : 'Unknown error' });
         }
     }
 
-    return { patched, failed, skipped };
+    return { patched, failed, skipped, verified };
 }
 
 function unpatchClientConfig(opts = {}) {

package/cli/run.test.js

@@ -30,8 +30,19 @@ const { handleInit, resolveMcpSmokeTarget } = require('./commands/axi');
 const cliPath = path.join(__dirname, 'run.js');
 const testGxPath = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-gx-'));
 fs.writeFileSync(path.join(testGxPath, 'genexus.exe'), '');
-const testGatewayEnv = { GENEXUS_MCP_GATEWAY_EXE: process.execPath };
-test.after(() => fs.rmSync(testGxPath, { recursive: true, force: true }));
+const testGatewayPath = path.join(os.tmpdir(), `genexus-mcp-test-${process.pid}`, 'GxMcp.Gateway.exe');
+fs.mkdirSync(path.dirname(testGatewayPath), { recursive: true });
+if (process.platform === 'win32') {
+    fs.copyFileSync(process.env.ComSpec || 'C:\\Windows\\System32\\cmd.exe', testGatewayPath);
+} else {
+    fs.writeFileSync(testGatewayPath, '#!/bin/sh\nexit 0\n');
+    fs.chmodSync(testGatewayPath, 0o755);
+}
+const testGatewayEnv = { GENEXUS_MCP_GATEWAY_EXE: testGatewayPath };
+test.after(() => {
+    fs.rmSync(testGxPath, { recursive: true, force: true });
+    fs.rmSync(testGatewayPath, { force: true });
+});
 
 function runCli(args, opts = {}) {
     const spawnOptions = {
@@ -1641,6 +1652,125 @@ test('clients list flags a registered command pointing at a missing launcher as
     fs.rmSync(tempRoot, { recursive: true, force: true });
 });
 
+test('clients list separates a registered node launcher without an entrypoint from semantic validity', () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-node-no-entrypoint-'));
+    try {
+        const env = sandboxHomeEnv(tempRoot);
+        const codexCfg = path.join(env.HOME, '.codex', 'config.toml');
+        fs.mkdirSync(path.dirname(codexCfg), { recursive: true });
+        const nodeCommand = process.execPath.replace(/\\/g, '\\\\').replace(/"/g, '\\\\"');
+        fs.writeFileSync(codexCfg, [
+            '[mcp_servers.genexus18mcp]',
+            `command = "${nodeCommand}"`,
+            'args = []',
+            ''
+        ].join('\n'));
+
+        const result = runCli(['clients', '--format', 'json'], { env });
+        assert.equal(result.status, 0, 'clients diagnostics retain the successful list exit code');
+        const parsed = JSON.parse(result.stdout);
+        const codex = parsed.ok.clients.find((client) => client.id === 'codex-cli');
+        assert.ok(codex, 'Codex CLI should be listed');
+        assert.equal(codex.registered, true, 'the config entry remains registered');
+        assert.equal(codex.command, process.execPath, 'the effective command is reported');
+        assert.deepEqual(codex.args, [], 'the effective args are reported');
+        assert.equal(codex.launcherStructuralState, 'present', 'node.exe exists locally');
+        assert.equal(codex.launcherSemanticState, 'invalid', 'node.exe without an entrypoint cannot start MCP');
+        assert.match(codex.launcherSemanticReason, /entrypoint/i, 'the reason tells the operator what is missing');
+        assert.equal(codex.commandStale, true, 'known invalid launcher is actionable through the existing stale flag');
+        assert.match(codex.commandStaleReason, /entrypoint/i);
+    } finally {
+        fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+});
+
+test('clients list validates existing Gateway and known npx launchers locally', () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-known-launchers-'));
+    try {
+        const env = sandboxHomeEnv(tempRoot);
+        const gatewayPath = path.join(tempRoot, 'publish', 'GxMcp.Gateway.exe');
+        const antigravityCfg = path.join(tempRoot, '.gemini', 'antigravity', 'mcp_config.json');
+        const cursorCfg = path.join(tempRoot, '.cursor', 'mcp.json');
+        const codexCfg = path.join(tempRoot, '.codex', 'config.toml');
+        const nodeEntrypoint = path.join(__dirname, 'run.js');
+        fs.mkdirSync(path.dirname(gatewayPath), { recursive: true });
+        fs.mkdirSync(path.dirname(antigravityCfg), { recursive: true });
+        fs.mkdirSync(path.dirname(cursorCfg), { recursive: true });
+        fs.mkdirSync(path.dirname(codexCfg), { recursive: true });
+        fs.writeFileSync(gatewayPath, 'gateway');
+        fs.writeFileSync(antigravityCfg, JSON.stringify({
+            mcpServers: { genexus18mcp: { command: gatewayPath, args: [] } }
+        }, null, 2));
+        fs.writeFileSync(cursorCfg, JSON.stringify({
+            mcpServers: { genexus18mcp: { command: 'npx.cmd', args: ['-y', 'genexus-mcp@latest'] } }
+        }, null, 2));
+        const nodeCommand = process.execPath.replace(/\\/g, '\\\\');
+        const nodeScript = nodeEntrypoint.replace(/\\/g, '\\\\');
+        fs.writeFileSync(codexCfg, [
+            '[mcp_servers.genexus18mcp]',
+            `command = "${nodeCommand}"`,
+            `args = ["${nodeScript}"]`,
+            ''
+        ].join('\n'));
+
+        const result = runCli(['clients', '--format', 'json'], {
+            env: { ...env, GENEXUS_MCP_GATEWAY_EXE: gatewayPath }
+        });
+        assert.equal(result.status, 0, `${result.stderr}\n${result.stdout}`);
+        const parsed = JSON.parse(result.stdout);
+        const gateway = parsed.ok.clients.find((client) => client.id === 'antigravity');
+        const npx = parsed.ok.clients.find((client) => client.id === 'cursor');
+        assert.ok(gateway && npx, 'both configured clients should be listed');
+
+        assert.equal(gateway.registered, true);
+        assert.equal(gateway.command, gatewayPath);
+        assert.deepEqual(gateway.args, []);
+        assert.equal(gateway.launcherStructuralState, 'present');
+        assert.equal(gateway.launcherSemanticState, 'valid');
+        assert.equal(gateway.commandStale, false);
+
+        assert.equal(npx.registered, true);
+        assert.equal(npx.command, 'npx.cmd');
+        assert.deepEqual(npx.args, ['-y', 'genexus-mcp@latest']);
+        assert.equal(npx.launcherStructuralState, 'present');
+        assert.equal(npx.launcherSemanticState, 'valid');
+        assert.equal(npx.commandStale, false);
+
+        const node = parsed.ok.clients.find((client) => client.id === 'codex-cli');
+        assert.ok(node, 'Codex CLI should be listed');
+        assert.equal(node.command, process.execPath);
+        assert.deepEqual(node.args, [nodeEntrypoint]);
+        assert.equal(node.launcherStructuralState, 'present');
+        assert.equal(node.launcherSemanticState, 'valid');
+        assert.equal(node.commandStale, false);
+        assert.equal(parsed.ok.summary.semanticInvalid, 0);
+    } finally {
+        fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+});
+
+test('clients list keeps an existing unrecognized launcher indeterminate', () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-unknown-launcher-'));
+    try {
+        const env = sandboxHomeEnv(tempRoot);
+        const cursorCfg = path.join(tempRoot, '.cursor', 'mcp.json');
+        fs.mkdirSync(path.dirname(cursorCfg), { recursive: true });
+        fs.writeFileSync(cursorCfg, JSON.stringify({
+            mcpServers: { genexus18mcp: { command: 'custom-mcp-launcher', args: ['--stdio'] } }
+        }, null, 2));
+
+        const result = runCli(['clients', '--format', 'json'], { env });
+        assert.equal(result.status, 0);
+        const cursor = JSON.parse(result.stdout).ok.clients.find((client) => client.id === 'cursor');
+        assert.equal(cursor.registered, true);
+        assert.equal(cursor.launcherStructuralState, 'indeterminate');
+        assert.equal(cursor.launcherSemanticState, 'unknown');
+        assert.equal(cursor.commandStale, false, 'unknown commands are not treated as invalid');
+    } finally {
+        fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+});
+
 test('clients list marks an Antigravity launcher from an old package cache as stale', () => {
     const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'genexus-mcp-antigravity-stale-'));
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genexus-mcp",
-  "version": "3.4.2",
+  "version": "3.5.0",
   "mcpName": "io.github.lennix1337/genexus",
   "description": "GeneXus 17, GeneXus 18 MCP server — read, edit, and analyze Knowledge Base objects directly from Claude, Cursor, and other AI agents over the Model Context Protocol.",
   "keywords": [
@@ -35,6 +35,7 @@
     "test": "node --test cli/run.test.js cli/lib/client-adapters.test.js cli/docs.test.js scripts/lint.test.js && npm run test:live-contract",
     "lint": "node scripts/lint.js",
     "test:live-contract": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/tests/test-live.test.ps1",
+    "test:integration": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/integration-preflight.ps1",
     "test:upstream-drift": "pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/tests/test-upstream-drift.ps1",
     "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=v10.0": {},
     ".NETCoreApp,Version=v10.0/win-x64": {
-      "GxMcp.Gateway/3.4.2": {
+      "GxMcp.Gateway/3.5.0": {
         "dependencies": {
           "Newtonsoft.Json": "13.0.3",
           "System.Management": "10.0.5",
@@ -66,7 +66,7 @@
     }
   },
   "libraries": {
-    "GxMcp.Gateway/3.4.2": {
+    "GxMcp.Gateway/3.5.0": {
       "type": "project",
       "serviceable": false,
       "sha512": ""

package/publish/config.json

@@ -1,19 +1,19 @@
 {
+  "ConfigSchemaVersion": 2,
   "Environment": {
     "ResolutionPolicy": "strict"
   },
-  "ConfigSchemaVersion": 2,
-  "GeneXus": {
-    "WorkerExecutable": "worker\\\\GxMcp.Worker.exe",
-    "InstallationPath": "C:\\Program Files (x86)\\GeneXus\\GeneXus18"
-  },
-  "GatewayMode": "stdio-isolated",
   "Server": {
-    "McpStdio": true,
     "HttpPort": 0,
-    "EmitStructuredContent": false,
-    "SessionIdleTimeoutMinutes": 10,
+    "TerseResponses": true,
+    "McpStdio": true,
     "WorkerIdleTimeoutMinutes": 5,
-    "TerseResponses": true
+    "EmitStructuredContent": false,
+    "SessionIdleTimeoutMinutes": 10
+  },
+  "GatewayMode": "stdio-isolated",
+  "GeneXus": {
+    "InstallationPath": "C:\\Program Files (x86)\\GeneXus\\GeneXus18",
+    "WorkerExecutable": "worker\\\\GxMcp.Worker.exe"
   }
 }

package/publish/gxmcp-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": "gxmcp-release-manifest/1",
-  "version": "3.4.2",
-  "sourceCommit": "5d38111f28d81e59ea31f5f792950809a8090f3e",
+  "version": "3.5.0",
+  "sourceCommit": "30cbc75a0bf7edb088879395ba9ea82857ce60f2",
   "sourceCommitPolicy": "exact-tag",
-  "generatedAtUtc": "2026-09-13T07:17:16.7652929Z",
+  "generatedAtUtc": "2026-09-14T18:52:46.1727079Z",
   "runtime": {
     "gateway": "net10.0-windows",
     "worker": "net48-x86",
@@ -15,28 +15,28 @@
     "2026-07-28"
   ],
   "schema": "tool_definitions.json",
-  "schemaSha256": "33938ec15d5eaa6d00507d37dbb6d8bdbb005f823b98f8c9894fd9d89dceb640",
+  "schemaSha256": "05b92690c10919de5059d00ab28fb4e91a67643436d0be186cecec6d962c3652",
   "provenance": "gxmcp-sbom.json",
   "artifacts": [
     {
       "path": "gxmcp-sbom.json",
       "size": 590,
-      "sha256": "124327c27bb2ae764f1e41d379d145192c39e8f0f0049d045fae1e8e05b1f44e"
+      "sha256": "929178a25b44d92d554aeaf85ac7479671a8d72aea5c4ebd8b78944154a6179d"
     },
     {
       "path": "GxMcp.Gateway.exe",
       "size": 162304,
-      "sha256": "0f4838234342836b84f71de8bac102883a799ff9990d1856c49043711fbaac7c"
+      "sha256": "6a41baf3616dacd48c28897126eb54f9fd90bfc6769b3b0b56f74958d8ac0b15"
     },
     {
       "path": "tool_definitions.json",
-      "size": 112865,
-      "sha256": "33938ec15d5eaa6d00507d37dbb6d8bdbb005f823b98f8c9894fd9d89dceb640"
+      "size": 112952,
+      "sha256": "05b92690c10919de5059d00ab28fb4e91a67643436d0be186cecec6d962c3652"
     },
     {
       "path": "worker/GxMcp.Worker.exe",
-      "size": 3106304,
-      "sha256": "b2a19ddba99b48df656709aca60079d17a544a5edd4a61e6e2f48f24d0accb44"
+      "size": 3118080,
+      "sha256": "67d74b177474aa6bd36c35d596e182c78ef13644712641a548e2ee4f72b7e62b"
     }
   ]
 }

package/publish/gxmcp-sbom.json

@@ -1,20 +1,20 @@
 {
   "schemaVersion": "gxmcp-provenance/1",
-  "version": "3.4.2",
-  "sourceCommit": "5d38111f28d81e59ea31f5f792950809a8090f3e",
+  "version": "3.5.0",
+  "sourceCommit": "30cbc75a0bf7edb088879395ba9ea82857ce60f2",
   "sourceCommitPolicy": "exact-tag",
   "components": [
     {
       "name": "genexus-mcp",
       "lockfile": "package-lock.json",
       "size": 39914,
-      "sha256": "b334c1359b3bbf02ca0a94cec034a50154bcce11621c71347c80f6253918f346"
+      "sha256": "5f9c6a7eb099831205bd7d1d40fee00420b044ad7459ae6d119eb2027b456dca"
     },
     {
       "name": "nexus-ide",
       "lockfile": "src/nexus-ide/package-lock.json",
       "size": 274983,
-      "sha256": "dec6919a7db31734eadc784d8143eb93d59420990c2b57987f695f683358d5ad"
+      "sha256": "48726bc21de60b115e70287234d18dae2fbe845871b20d0d131c032c6210b6aa"
     }
   ]
 }

package/publish/tool_definitions.json

@@ -39,7 +39,7 @@
   {"name":"genexus_kb_version","description":"KB model-version management (Create Version/Branch/Activate/Revert) over the SDK's KBVersionHelper — the IDE Version menu's code path. action=list is read-only; freeze/branch/set_active/revert mutate the KB's version tree. Version results keep lastUpdate separate from createdAt; createdAt is null with createdAtAvailable=false when the SDK has no reliable creation timestamp.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["list","freeze","branch","set_active","revert"],"description":"KB model-version or branch operation to perform."},"name":{"type":"string","description":"New version/branch name (freeze/branch)."},"description":{"type":"string","description":"New version/branch description (freeze/branch)."},"parentVersion":{"type":"string","description":"Parent version name (freeze/branch). Defaults to the active version."},"targetVersion":{"type":"string","description":"Version to activate (set_active) or revert to (revert)."},"fromVersion":{"type":"string","description":"revert: source version. Defaults to the active version."},"backupModel":{"type":"boolean","description":"freeze: back up the KB model. Default false."},"includeEnvironments":{"type":"boolean","description":"branch: include environments. Default false."},"autoUpdate":{"type":"boolean","description":"set_active: auto-update the working model. Default false."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"list"},{"action":"freeze","name":"v1.0","description":"Release 1.0"},{"action":"set_active","targetVersion":"Trunk"}]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_browser","description":"Headless-browser verification umbrella. action=smoke (HTTP 200 + clean console), a11y (axe), wcag (caption/tooltip lint), capture (console/network/exceptions), cross (multi-engine), preview (render WebPanel + capture HTML/a11y/screenshot, optionally diff baseline). preview uses mode=render|run (default render; run auto-resolves the KB launcher, IDE F5 parity).","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["smoke","a11y","wcag","capture","cross","preview"],"description":"Browser verification operation to execute."},"name":{"type":"string","description":"WebPanel name."},"mode":{"type":"string","enum":["render","run"],"description":"preview only."},"capture":{"type":"array","items":{"type":"string"},"description":"capture|cross|preview channels: console|network|exceptions|html|a11y|screenshot."},"browsers":{"type":"array","items":{"type":"string","enum":["chrome","firefox","safari","webkit"]},"description":"cross only."},"parms":{"type":"object","description":"preview only."},"launcher":{"type":"string","description":"preview only."},"buildFirst":{"type":"boolean","description":"preview only."},"waitMs":{"type":"integer","description":"preview only."},"diffBaseline":{"type":"boolean","description":"preview only."},"updateBaseline":{"type":"boolean","description":"preview only."},"fill":{"type":"object","description":"preview only."},"click":{"type":"string","description":"preview only."},"auth":{"type":"object","description":"preview only."},"emulate":{"type":"string","enum":["iPhone12","iPhone15Pro","iPadPro","Pixel7","desktop1920","desktop1280"],"description":"preview only."},"network":{"type":"string","enum":["fast","slow3g","fast3g","offline"],"description":"preview only."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"preview","name":"WPMain"},{"action":"cross","name":"WPMain","browsers":["chrome","firefox"]}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true}},
   {"name":"genexus_db","description":"Database umbrella. action: drift_check|drift_report (Transaction↔DB schema drift) | optimize_analyze|optimize_suggest|optimize_report (static index advisor) | sql_ddl|sql_navigation (SQL for Transaction/Procedure) | sample_data (fake INSERTs) | records_query|records_insert|records_update (typed application rows through Transaction metadata; writes default to dryRun; direct SQL only and no GeneXus business rules) | types_list|types_describe|types_validate (Domains/SDT constraints) | reorg_impact (timestamp/deep ImpactDatabase) | reorg_preview (non-mutating logical↔physical impact diff plus exact SQL only when a current artifact is available) | translations_import.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["drift_check","drift_report","optimize_analyze","optimize_suggest","optimize_report","sql_ddl","sql_navigation","sample_data","records_query","records_insert","records_update","types_list","types_describe","types_validate","translations_import","reorg_impact","reorg_preview"],"description":"Database operation. records_query is read-only; records_insert/records_update default to dryRun=true and require the matching single-use v2 preview token for persistence."},"deep":{"type":"boolean","description":"reorg_impact/reorg_preview only: run ISpecifierService.ImpactDatabase (specification, build-heavy) for the authoritative AnalysisResult. Default false (cheap timestamp heuristic)."},"name":{"type":"string","description":"Object/transaction/type name."},"trn":{"type":"string","description":"sample_data: Transaction name."},"transaction":{"type":"string","description":"records_*: root-level Transaction name."},"dataStore":{"type":"string","description":"records_*: existing active-environment datastore; defaults to the SDK default."},"where":{"type":"object","description":"records_query/update: equality filters only; update requires a filter."},"values":{"type":"object","description":"records_insert/update: typed attribute values."},"fields":{"type":"array","items":{"type":"string"},"description":"records_query: optional root-attribute projection."},"databaseManagedFields":{"type":"array","items":{"type":"string"},"description":"records_*: reviewed trigger-maintained fields; excludes keys and supplied values. Included in the preview token."},"limit":{"type":"integer","description":"records_query: 1-1000; default 100."},"expectedCount":{"type":"integer","description":"records_update: defaults to exactly one matched record."},"expectedVersion":{"type":"string","description":"records_*: v2 token from the matching write dry-run; query/v1 tokens cannot authorize writes."},"versionToken":{"type":"string","description":"records_*: alias of expectedVersion."},"dryRun":{"type":"boolean","default":true,"description":"records_insert/update: validate and reread the plan without writing."},"rollbackOnFailure":{"type":"boolean","default":true,"description":"records_*: default true; validation failures roll back before commit. Post-commit compensation is refused to preserve concurrent writers."},"timeoutSeconds":{"type":"integer","description":"records_*: command timeout, 1-60 seconds."},"rows":{"type":"integer","description":"sample_data: 1-1000; default 5."},"includeSubordinated":{"type":"boolean","description":"sql_ddl only."},"levelNumber":{"type":"integer","description":"sql_navigation only."},"includeExecutionPlan":{"type":"boolean","description":"sql_navigation."},"includeIndexAdvisor":{"type":"boolean","description":"sql_navigation."},"format":{"type":"string","enum":["json","markdown"],"description":"optimize_report only."},"kind":{"type":"string","enum":["domain","sdt","all"],"description":"types_list filter."},"value":{"type":"string","description":"types_validate."},"type":{"type":"string","description":"types_validate / disambiguator."},"inputPath":{"type":"string","description":"translations_import: CSV path."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"drift_check"},{"action":"sql_ddl","name":"Customer"},{"action":"reorg_preview","name":"Customer","deep":true}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
-  {"name":"genexus_versioning","description":"Versioning umbrella. action: history_list|history_get|history_save|history_restore (snapshot store; restore+discard=true is IDE 'Discard changes' parity) | undo (revert last N edits) | time_travel (recover bytes from a past git commit) | blame (git blame an object part) | diff (text: mode=textVsText|currentVsText) | diff_generated (against=last-build|git-head).","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["history_list","history_get","history_save","history_restore","undo","time_travel","blame","diff","diff_generated"],"description":"History, diff, time-travel, or rollback operation to perform."},"name":{"type":"string","description":"Object name for history, diff, time_travel, or blame."},"part":{"type":"string","description":"Object part name, e.g. Source, Rules, Events."},"versionId":{"type":"integer","description":"history_get/history_restore: numerical version ID."},"snapshot":{"type":"string","description":"history_restore: snapshot label or path to restore."},"discard":{"type":"boolean","description":"history_restore: true for IDE 'Discard changes' parity."},"dryRun":{"type":"boolean","description":"history_restore/undo: preview without mutating the KB."},"last":{"type":"integer","description":"undo: default 1, max 20."},"at":{"type":"string","description":"time_travel: ISO-8601 or commit sha."},"line":{"type":"integer","description":"blame: 1-based line number to annotate."},"filePath":{"type":"string","description":"blame: absolute or KB-relative file path."},"context":{"type":"integer","description":"blame: surrounding lines of context."},"mode":{"type":"string","enum":["textVsText","currentVsText"],"description":"diff."},"left":{"type":"string","description":"diff: left-side text or snapshot label."},"right":{"type":"string","description":"diff: right-side text or snapshot label."},"against":{"type":"string","enum":["last-build","git-head"],"description":"diff_generated."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"history_list","name":"Customer"},{"action":"time_travel","name":"Customer","at":"2026-05-20T10:00:00Z"}]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},
+  {"name":"genexus_versioning","description":"Versioning umbrella. action: history_list|history_get|history_save|history_restore (snapshot store; restore+discard=true is IDE 'Discard changes' parity) | undo (revert last N edits) | time_travel (recover bytes from a past git commit) | blame (git blame an object part) | diff (text: mode=textVsText|currentVsText) | diff_generated (against=last-build|git-head).","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["history_list","history_get","history_save","history_restore","undo","time_travel","blame","diff","diff_generated"],"description":"History, diff, time-travel, or rollback operation to perform."},"name":{"type":"string","description":"Object name for history, diff, time_travel, or blame."},"part":{"type":"string","description":"Object part name, e.g. Source, Rules, Events."},"partName":{"type":"string","description":"Legacy alias for part on history actions."},"versionId":{"type":"integer","description":"history_get/history_restore: numerical version ID."},"snapshot":{"type":"string","description":"history_restore: snapshot label or path to restore."},"discard":{"type":"boolean","description":"history_restore: true for IDE 'Discard changes' parity."},"dryRun":{"type":"boolean","description":"history_restore/undo: preview without mutating the KB."},"last":{"type":"integer","description":"undo: default 1, max 20."},"at":{"type":"string","description":"time_travel: ISO-8601 or commit sha."},"line":{"type":"integer","description":"blame: 1-based line number to annotate."},"filePath":{"type":"string","description":"blame: absolute or KB-relative file path."},"context":{"type":"integer","description":"blame: surrounding lines of context."},"mode":{"type":"string","enum":["textVsText","currentVsText"],"description":"diff."},"left":{"type":"string","description":"diff: left-side text or snapshot label."},"right":{"type":"string","description":"diff: right-side text or snapshot label."},"against":{"type":"string","enum":["last-build","git-head"],"description":"diff_generated."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"history_list","name":"Customer"},{"action":"time_travel","name":"Customer","at":"2026-05-20T10:00:00Z"}]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_io","description":"IO umbrella for assets, Object Text exchange, screenshots, OCR. action: asset_find|asset_read|asset_write | export_part|import_part (single part) | export_kb_to_text|import_text_to_kb|validate_kb_text_files|delete_kb_objects (official GeneXus for Agents Object Text parity) | export_unified|screenshot_publish|ocr.","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["asset_find","asset_read","asset_write","export_part","import_part","export_kb_to_text","import_text_to_kb","validate_kb_text_files","delete_kb_objects","export_unified","screenshot_publish","ocr"],"description":"Asset, single-part, batch Object Text, screenshot, or OCR operation."},"path":{"type":"string","description":"asset/screenshot_publish/ocr: file path; Object Text import/validate may use a manifest directory."},"name":{"type":"string","description":"single object name or comma-separated selector; export_unified uses one object."},"targets":{"type":"array","items":{},"description":"Object Text selector array. Items may be names or {name,type} objects. Omit for export_kb_to_text to export the full indexed KB."},"outputPath":{"type":"string","description":"export_part: destination file; export_kb_to_text: destination directory."},"inputPath":{"type":"string","description":"import_part: source file; import_text_to_kb/validate_kb_text_files: manifest or directory."},"part":{"type":"string","description":"Object Text or part-exchange part name (e.g. Source, Rules, WebForm)."},"type":{"type":"string","description":"Object type disambiguator/filter."},"module":{"type":"string","description":"Object Text module filter."},"pathPrefix":{"type":"string","description":"Object Text KB object-path prefix filter."},"overwrite":{"type":"boolean","description":"export_part/export_kb_to_text: overwrite existing output."},"confirm":{"type":"boolean","description":"delete_kb_objects: required for a real delete; dryRun remains non-mutating."},"dryRun":{"type":"boolean","description":"Object Text import/delete preview without persisting changes."},"async":{"type":"boolean","description":"Run a batch Object Text operation as a cancellable background job when supported."},"pattern":{"type":"string","description":"asset_find: glob pattern."},"relativeRoot":{"type":"string","description":"asset_find: root for relative paths."},"limit":{"type":"integer","description":"asset_find/Object Text: max results."},"includeContent":{"type":"boolean","description":"asset_find: inline file content."},"maxBytes":{"type":"integer","description":"asset_read: max bytes to return."},"contentBase64":{"type":"string","description":"asset_write: base64-encoded file content."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"export_kb_to_text","outputPath":"C:\\tmp\\customer-text","targets":[{"name":"Customer","type":"Transaction"}]},{"action":"validate_kb_text_files","inputPath":"C:\\tmp\\customer-text"},{"action":"delete_kb_objects","targets":["Procedure:OldProc"],"dryRun":true}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_variable","description":"Variables CRUD. add accepts varName or variables[] batch; modify changes type atomically. basedOn binds a Domain by native SDK identity. objectType=BusinessComponent with objectName+module binds a modular BC by EntityKey/GUID and verifies it after save. length/decimals override size; collection=true declares a collection; untyped add inherits a same-named attribute. dryRun validates and previews without mutation; async returns an operationId.","inputSchema":{"type":"object","required":["action","name"],"properties":{"action":{"type":"string","enum":["add","delete","modify"],"description":"Variable-part operation to add, delete, or modify a variable."},"name":{"type":"string"},"varName":{"type":"string","description":"Single-variable form (add/delete/modify). For batch add use variables[] instead."},"variables":{"type":"array","description":"Batch add only: one object per variable — {varName, typeName?, length?, decimals?, collection?}. Added before a single save.","items":{"type":"object","required":["varName"],"properties":{"varName":{"type":"string"},"typeName":{"type":"string"},"length":{"type":"integer"},"decimals":{"type":"integer"},"collection":{"type":"boolean"},"basedOn":{"type":"string","description":"Domain name; native SDK reference."}}}},"typeName":{"type":"string","description":"Primitive (Character/Numeric/VarChar/Date/...), SDT/BC/Domain name, or WebSession. VarChar keeps VARCHAR semantics."},"objectType":{"type":"string","enum":["BusinessComponent"],"description":"add/modify: resolve an object-backed variable natively instead of interpreting typeName as a Domain."},"objectName":{"type":"string","description":"Business Component Transaction name, without module when module is passed separately."},"module":{"type":"string","description":"Module owning objectName. Required to disambiguate modular Business Components."},"expectedVersion":{"type":"string","description":"Optimistic-concurrency token for an object-backed add/modify. Stale state returns VersionConflict before mutation."},"length":{"type":"integer","description":"add/modify optional: overrides the length parsed from typeName."},"decimals":{"type":"integer","description":"add/modify optional: overrides decimals parsed from typeName."},"collection":{"type":"boolean","description":"add/modify optional: declare the variable as a collection."},"basedOn":{"type":"string","description":"modify optional: Domain."},"dryRun":{"type":"boolean","default":false,"description":"Validate and return the typed diff without changing any object, Attribute, hash, or version."},"validationMode":{"type":"string","enum":["specify"],"description":"Explicitly run the inline Specify pass after a legacy variable write. Never runs unless requested."},"rollbackOnFailure":{"type":"boolean","default":true,"description":"Object-backed variables always snapshot the complete owner and restore it on save/re-read divergence."},"async":{"type":"boolean","description":"Run as a background job. Result returns operationId/job_id for genexus_lifecycle polling."},"estimated_seconds":{"type":"integer","description":"When async=true, expected runtime used for progress/job metadata (default 30)."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"add","name":"MyPanel","varName":"&Choice","typeName":"Numeric"},{"action":"add","name":"MyProc","varName":"&OrderRecord","objectType":"BusinessComponent","objectName":"OrderRecord","module":"Operations","dryRun":true},{"action":"add","name":"MyProc","variables":[{"varName":"&ApiKey","typeName":"VarChar","length":80},{"varName":"&CmdNro","typeName":"Numeric","length":9}]},{"action":"delete","name":"MyPanel","varName":"&OldVar"}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},
   {"name":"genexus_telemetry","description":"Observability umbrella. action: executions (recent invocations) | watch_event (ops mentioning an event) | friction_append|friction_tail (.gx/friction.jsonl) | learning_report (aggregate friction) | logs (worker_debug.log tail) | profile_analyze|profile_hotspots|profile_correlate (GeneXus profiler XML).","inputSchema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["executions","watch_event","friction_append","friction_tail","learning_report","logs","profile_analyze","profile_hotspots","profile_correlate"],"description":"Telemetry, profiling, or friction-log operation to perform."},"target":{"type":"string","description":"executions/watch_event: object name to filter."},"event":{"type":"string","description":"watch_event: event name to match in operation payload."},"last":{"type":"integer","description":"executions/watch_event: max results."},"tool":{"type":"string","description":"friction_append: tool name that produced the friction entry."},"message":{"type":"string","description":"friction_append: description of the friction encountered."},"severity":{"type":"string","enum":["info","warn","error","critical"],"description":"friction_append: severity level."},"n":{"type":"integer","description":"friction_tail: number of recent lines to return."},"since":{"type":"string","description":"learning_report/logs: ISO-8601 start time filter."},"until":{"type":"string","description":"learning_report: ISO-8601 end time filter."},"tail":{"type":"integer","description":"logs: number of tail lines from worker_debug.log."},"filterCorrelation":{"type":"string","description":"logs: filter by correlation/operation ID."},"grep":{"type":"string","description":"logs: substring filter on log lines."},"path":{"type":"string","description":"profile_*: path to the GeneXus profiler XML file."},"top":{"type":"integer","description":"profile_hotspots: top-N hottest procedures to return."},"kb":{"type":"string","description":"KB alias."}},"examples":[{"action":"executions"},{"action":"friction_tail","n":20}]},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},