arc-1 0.9.14 → 0.9.16

package/dist/handlers/context.js

@@ -0,0 +1,344 @@
+/**
+ * SAPContext handler — object context: relatives, hierarchy, method listings, CDS upstream/
+ * downstream dependency analysis.
+ */
+import { buildSiblingExtensionFinding, classifyCdsImpact, deriveSiblingStem, isSiblingNameMatch, } from '../adt/cds-impact.js';
+import { findWhereUsed } from '../adt/codeintel.js';
+import { AdtApiError } from '../adt/errors.js';
+import { mapSapReleaseToAbaplintVersion } from '../adt/features.js';
+import { extractCdsDependencies } from '../context/cds-deps.js';
+import { compressCdsContext, compressContext } from '../context/compressor.js';
+import { logger } from '../server/logger.js';
+import { contextCacheForDependencyPayloads } from './cache-security.js';
+import { cachedFeatures } from './feature-cache.js';
+import { normalizeObjectType, objectUrlForType } from './object-types.js';
+import { errorResult, textResult } from './shared.js';
+// ─── SAPContext Handler ───────────────────────────────────────────────
+const DEFAULT_SIBLING_MAX_CANDIDATES = 4;
+const HARD_MAX_SIBLING_MAX_CANDIDATES = 10;
+function parseSiblingMaxCandidates(value) {
+    const parsed = Number(value ?? DEFAULT_SIBLING_MAX_CANDIDATES);
+    if (!Number.isFinite(parsed))
+        return DEFAULT_SIBLING_MAX_CANDIDATES;
+    const rounded = Math.trunc(parsed);
+    return Math.min(Math.max(rounded, 1), HARD_MAX_SIBLING_MAX_CANDIDATES);
+}
+export async function handleSAPContext(client, args, cachingLayer, cacheSecurity) {
+    const action = String(args.action ?? '');
+    // action="impact" is DDLS-only on the server side — default the type so LLMs
+    // don't have to supply it redundantly (and don't get a validation retry when
+    // they don't). Any non-DDLS value still fails the guardrail below.
+    const rawType = String(args.type ?? '');
+    const type = normalizeObjectType(rawType || (action === 'impact' ? 'DDLS' : ''));
+    const name = String(args.name ?? '');
+    // Bound dependency fan-out: a huge maxDeps would fan out unbounded SAP fetches per level
+    // (depth is already capped at 3). Clamp to [1, 100]; non-finite/<1 falls back to the default 20.
+    const rawMaxDeps = Number(args.maxDeps ?? 20);
+    const maxDeps = Number.isFinite(rawMaxDeps) && rawMaxDeps >= 1 ? Math.min(Math.floor(rawMaxDeps), 100) : 20;
+    const depth = Math.min(Math.max(Number(args.depth ?? 1), 1), 3);
+    // ─── Reverse dep lookup (pre-warmer only) ─────────────────────────
+    if (action === 'usages') {
+        if (!name)
+            return errorResult('"name" is required for usages action.');
+        if (cacheSecurity.isPerUserClient) {
+            return errorResult('SAPContext(action="usages") is disabled under principal propagation because it reads the shared warmup index. ' +
+                `Use SAPNavigate(action="references", type="${type || 'CLAS'}", name="${name}") for a live SAP-authorized lookup.`);
+        }
+        if (!cachingLayer) {
+            return errorResult('Reverse dependency lookup requires object caching. Cache is disabled (ARC1_CACHE=none). ' +
+                'Enable caching and run cache warmup to use this feature.');
+        }
+        const usages = cachingLayer.getUsages(name);
+        if (usages === null) {
+            return errorResult(`Reverse dependency lookup requires a pre-warmed cache. The cache warmup has not been run yet.\n\n` +
+                `To enable this feature:\n` +
+                `1. Start ARC-1 with --cache-warmup (or set ARC1_CACHE_WARMUP=true)\n` +
+                `2. Wait for the warmup to complete (indexes all custom objects)\n` +
+                `3. Then retry SAPContext(action="usages", name="${name}")\n\n` +
+                `Alternative: Use SAPNavigate(action="references", type="CLAS", name="${name}") for a live ADT lookup (slower, but works without warmup).`);
+        }
+        if (usages.length === 0) {
+            return textResult(`No objects found that depend on "${name}" in the cached index.`);
+        }
+        return textResult(JSON.stringify({ name, usageCount: usages.length, usages }, null, 2));
+    }
+    if (!type || !name) {
+        return errorResult('Both "type" and "name" are required for SAPContext.');
+    }
+    // Helper: get source with cache support
+    const cachedGet = async (objType, objName, fetcher) => {
+        if (!cachingLayer)
+            return (await fetcher()).source;
+        const { source } = await cachingLayer.getSource(objType, objName, fetcher);
+        return source;
+    };
+    if (action === 'impact') {
+        if (type !== 'DDLS') {
+            return errorResult('SAPContext(action="impact") supports DDLS only. For non-CDS objects, use SAPNavigate(action="references").');
+        }
+        const ddlSource = await cachedGet('DDLS', name, (ifNoneMatch) => client.getDdls(name, { ifNoneMatch }));
+        const upstream = buildCdsUpstream(extractCdsDependencies(ddlSource));
+        const includeIndirect = args.includeIndirect === true;
+        const siblingCheck = args.siblingCheck !== false;
+        const siblingMaxCandidates = parseSiblingMaxCandidates(args.siblingMaxCandidates);
+        let downstream = classifyCdsImpact([], { includeIndirect });
+        const warnings = [];
+        const consistencyHints = [];
+        let siblingExtensionAnalysis;
+        try {
+            const whereUsed = await findWhereUsed(client.http, client.safety, objectUrlForType('DDLS', name));
+            downstream = classifyCdsImpact(whereUsed, { includeIndirect });
+        }
+        catch (err) {
+            if (err instanceof AdtApiError && [404, 405, 415, 501].includes(err.statusCode)) {
+                warnings.push('Where-used endpoint not available on this system');
+            }
+            else {
+                throw err;
+            }
+        }
+        if (siblingCheck && warnings.length === 0) {
+            try {
+                const targetName = name.toUpperCase();
+                const stem = deriveSiblingStem(targetName);
+                // Guard against over-broad sibling searches for short/degenerate stems
+                // (e.g., target "Z1" -> stem "Z" -> searchQuery "Z*" would scan the full Z namespace).
+                if (stem.length < 3) {
+                    warnings.push(`Sibling consistency check skipped: derived stem "${stem}" is too short to identify siblings safely.`);
+                }
+                else {
+                    const targetMatches = await client.searchObject(targetName, 25);
+                    const targetMatch = targetMatches.find((candidate) => normalizeObjectType(candidate.objectType) === 'DDLS' && candidate.objectName.toUpperCase() === targetName);
+                    const targetPackageName = targetMatch?.packageName;
+                    if (!targetPackageName) {
+                        warnings.push(`Sibling consistency check skipped: could not resolve package for DDLS "${targetName}".`);
+                    }
+                    else {
+                        const searchQuery = `${stem}*`;
+                        const searchMaxResults = Math.min(100, Math.max(siblingMaxCandidates * 4, siblingMaxCandidates + 4));
+                        const siblingCandidates = await client.searchObject(searchQuery, searchMaxResults);
+                        const skipped = {
+                            self: 0,
+                            nonDdls: 0,
+                            packageMismatch: 0,
+                            nameMismatch: 0,
+                            overLimit: 0,
+                        };
+                        const filteredCandidates = [];
+                        const seenNames = new Set();
+                        for (const candidate of siblingCandidates) {
+                            if (normalizeObjectType(candidate.objectType) !== 'DDLS') {
+                                skipped.nonDdls += 1;
+                                continue;
+                            }
+                            const candidateName = candidate.objectName.toUpperCase();
+                            if (candidateName === targetName) {
+                                skipped.self += 1;
+                                continue;
+                            }
+                            if (candidate.packageName !== targetPackageName) {
+                                skipped.packageMismatch += 1;
+                                continue;
+                            }
+                            if (!isSiblingNameMatch(targetName, candidateName, stem)) {
+                                skipped.nameMismatch += 1;
+                                continue;
+                            }
+                            if (seenNames.has(candidateName)) {
+                                continue;
+                            }
+                            seenNames.add(candidateName);
+                            filteredCandidates.push({ name: candidateName, packageName: candidate.packageName });
+                        }
+                        const selectedCandidates = filteredCandidates.slice(0, siblingMaxCandidates);
+                        skipped.overLimit = Math.max(filteredCandidates.length - selectedCandidates.length, 0);
+                        const checkedCandidates = [];
+                        let skippedWhereUsedCandidates = 0;
+                        for (const candidate of selectedCandidates) {
+                            try {
+                                const siblingWhereUsed = await findWhereUsed(client.http, client.safety, objectUrlForType('DDLS', candidate.name));
+                                const siblingDownstream = classifyCdsImpact(siblingWhereUsed, { includeIndirect });
+                                checkedCandidates.push({
+                                    name: candidate.name,
+                                    packageName: candidate.packageName,
+                                    metadataExtensions: siblingDownstream.metadataExtensions.length,
+                                    downstreamTotal: siblingDownstream.summary.total,
+                                });
+                            }
+                            catch (err) {
+                                if (err instanceof AdtApiError && [404, 405, 415, 501].includes(err.statusCode)) {
+                                    skippedWhereUsedCandidates += 1;
+                                    continue;
+                                }
+                                throw err;
+                            }
+                        }
+                        if (skippedWhereUsedCandidates > 0) {
+                            warnings.push(`Sibling consistency check skipped ${skippedWhereUsedCandidates} candidate(s) due to where-used endpoint errors.`);
+                        }
+                        const siblingFinding = buildSiblingExtensionFinding({
+                            targetName,
+                            targetPackageName,
+                            stem,
+                            targetMetadataExtensions: downstream.metadataExtensions.length,
+                            siblings: checkedCandidates,
+                        });
+                        if (siblingFinding) {
+                            consistencyHints.push(siblingFinding.message);
+                        }
+                        siblingExtensionAnalysis = {
+                            enabled: true,
+                            stem,
+                            searchQuery,
+                            includeIndirect,
+                            maxCandidates: siblingMaxCandidates,
+                            filters: {
+                                samePackage: true,
+                                siblingStem: stem,
+                            },
+                            target: {
+                                name: targetName,
+                                packageName: targetPackageName,
+                                metadataExtensions: downstream.metadataExtensions.length,
+                            },
+                            consideredCandidates: filteredCandidates.length,
+                            checkedCandidates,
+                            skipped,
+                        };
+                    }
+                }
+            }
+            catch (err) {
+                logger.debug('Sibling consistency check aborted', {
+                    name,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                warnings.push('Sibling consistency check skipped due to search or where-used processing errors.');
+            }
+        }
+        const upstreamCount = upstream.tables.length + upstream.views.length + upstream.associations.length + upstream.compositions.length;
+        const response = {
+            name,
+            type: 'DDLS',
+            upstream,
+            downstream,
+            summary: {
+                upstreamCount,
+                downstreamTotal: downstream.summary.total,
+                downstreamDirect: downstream.summary.direct,
+            },
+            ...(consistencyHints.length > 0 ? { consistencyHints } : {}),
+            ...(siblingExtensionAnalysis ? { siblingExtensionAnalysis } : {}),
+            ...(warnings.length > 0 ? { warnings } : {}),
+        };
+        return textResult(JSON.stringify(response, null, 2));
+    }
+    // Get source — either provided or fetched from SAP
+    let source;
+    if (args.source) {
+        source = String(args.source);
+    }
+    else {
+        switch (type) {
+            case 'CLAS':
+                source = await cachedGet('CLAS', name, (ifNoneMatch) => client.getClass(name, undefined, { ifNoneMatch }));
+                break;
+            case 'INTF':
+                source = await cachedGet('INTF', name, (ifNoneMatch) => client.getInterface(name, { ifNoneMatch }));
+                break;
+            case 'PROG':
+                source = await cachedGet('PROG', name, (ifNoneMatch) => client.getProgram(name, { ifNoneMatch }));
+                break;
+            case 'FUNC': {
+                const group = String(args.group ?? '');
+                if (!group) {
+                    return errorResult('The "group" parameter is required for FUNC type. Use SAPSearch to find the function group.');
+                }
+                source = await cachedGet('FUNC', name, (ifNoneMatch) => client.getFunction(group, name, { ifNoneMatch }));
+                break;
+            }
+            case 'DDLS': {
+                const ddlSource = await cachedGet('DDLS', name, (ifNoneMatch) => client.getDdls(name, { ifNoneMatch }));
+                const cdsResult = await compressCdsContext(client, ddlSource, name, maxDeps, depth, contextCacheForDependencyPayloads(cachingLayer, cacheSecurity));
+                return textResult(cdsResult.output);
+            }
+            default:
+                return errorResult(`SAPContext supports types: CLAS, INTF, PROG, FUNC, DDLS. Got: ${type}`);
+        }
+    }
+    // Check dep graph cache — if source hash matches, return cached contracts
+    const dependencyPayloadCache = contextCacheForDependencyPayloads(cachingLayer, cacheSecurity);
+    if (dependencyPayloadCache) {
+        const cachedGraph = dependencyPayloadCache.getCachedDepGraph(source);
+        if (cachedGraph) {
+            const successful = cachedGraph.contracts.filter((c) => c.success);
+            const failed = cachedGraph.contracts.filter((c) => !c.success);
+            const lines = [];
+            lines.push(`* === Dependency context for ${name} (${successful.length} deps resolved${failed.length > 0 ? `, ${failed.length} failed` : ''}) [cached] ===`);
+            lines.push('');
+            for (const contract of successful) {
+                const typeLabel = contract.type.toLowerCase();
+                const methodLabel = contract.methodCount > 0 ? `, ${contract.methodCount} methods` : '';
+                lines.push(`* --- ${contract.name} (${typeLabel}${methodLabel}) ---`);
+                lines.push(contract.source.trim());
+                lines.push('');
+            }
+            if (failed.length > 0) {
+                lines.push('* --- Failed dependencies ---');
+                for (const f of failed) {
+                    lines.push(`* ${f.name}: ${f.error}`);
+                }
+                lines.push('');
+            }
+            const totalLines = lines.length;
+            lines.push(`* Stats: ${successful.length + failed.length} deps found, ${successful.length} resolved, ${failed.length} failed, ${totalLines} lines [from cache]`);
+            return textResult(lines.join('\n'));
+        }
+    }
+    // Use detected ABAP version from probe if available, otherwise Cloud (superset)
+    const abaplintVersion = cachedFeatures?.abapRelease
+        ? mapSapReleaseToAbaplintVersion(cachedFeatures.abapRelease)
+        : undefined;
+    const result = await compressContext(client, source, name, type, maxDeps, depth, abaplintVersion, dependencyPayloadCache);
+    return textResult(result.output);
+}
+function buildCdsUpstream(deps) {
+    const tableNames = new Set();
+    const viewNames = new Set();
+    const associationNames = new Set();
+    const compositionNames = new Set();
+    for (const dep of deps) {
+        const upperName = dep.name.toUpperCase();
+        if (dep.kind === 'association') {
+            associationNames.add(upperName);
+            continue;
+        }
+        if (dep.kind === 'composition') {
+            compositionNames.add(upperName);
+            continue;
+        }
+        if (dep.kind === 'projection_base') {
+            viewNames.add(upperName);
+            continue;
+        }
+        if (isLikelyCdsViewName(upperName)) {
+            viewNames.add(upperName);
+        }
+        else {
+            tableNames.add(upperName);
+        }
+    }
+    return {
+        tables: [...tableNames].sort().map((name) => ({ name })),
+        views: [...viewNames].sort().map((name) => ({ name })),
+        associations: [...associationNames].sort().map((name) => ({ name })),
+        compositions: [...compositionNames].sort().map((name) => ({ name })),
+    };
+}
+function isLikelyCdsViewName(name) {
+    if (name.startsWith('/')) {
+        return /\/[ICRPAZ][A-Z0-9_]*_/.test(name);
+    }
+    return /^(ZI_|ZC_|ZR_|ZP_|I_|C_|R_|P_)/.test(name);
+}
+//# sourceMappingURL=context.js.map

package/dist/handlers/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/handlers/context.ts"],"names":[],"mappings":"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"}

package/dist/handlers/diagnose.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SAPDiagnose handler — runtime diagnostics: short dumps (ST22), traces, gateway errors, object
+ * state, ATC, unit tests, CDS test cases.
+ */
+import type { AdtClient } from '../adt/client.js';
+import { type ToolResult } from './shared.js';
+export declare function handleSAPDiagnose(client: AdtClient, args: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/handlers/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/handlers/diagnose.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAyBlD,OAAO,EAAe,KAAK,UAAU,EAAc,MAAM,aAAa,CAAC;AAEvE,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAqO7G"}

package/dist/handlers/diagnose.js

@@ -0,0 +1,274 @@
+/**
+ * SAPDiagnose handler — runtime diagnostics: short dumps (ST22), traces, gateway errors, object
+ * state, ATC, unit tests, CDS test cases.
+ */
+import { applyFixProposal, getCdsTestCases, getFixProposals, runAtcCheck, runUnitTests, supportsCdsTestCases, syntaxCheck, } from '../adt/devtools.js';
+import { getDump, getGatewayErrorDetail, getObjectState, getTraceDbAccesses, getTraceHitlist, getTraceStatements, listDumps, listGatewayErrors, listSystemMessages, listTraces, } from '../adt/diagnostics.js';
+import { isBtpSystem } from './feature-cache.js';
+import { classIncludeUrl, normalizeObjectType, objectUrlForType, sourceUrlForType } from './object-types.js';
+import { errorResult, textResult } from './shared.js';
+export async function handleSAPDiagnose(client, args) {
+    const action = String(args.action ?? '');
+    const name = String(args.name ?? '');
+    const type = normalizeObjectType(String(args.type ?? ''));
+    switch (action) {
+        case 'syntax': {
+            const objectUrl = objectUrlForType(type, name);
+            const version = args.version === 'inactive' ? 'inactive' : args.version === 'active' ? 'active' : undefined;
+            const content = typeof args.source === 'string' ? args.source : undefined;
+            const opts = {};
+            if (version)
+                opts.version = version;
+            if (content !== undefined)
+                opts.content = content;
+            const result = await syntaxCheck(client.http, client.safety, objectUrl, Object.keys(opts).length > 0 ? opts : undefined);
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        case 'unittest': {
+            const objectUrl = objectUrlForType(type, name);
+            const results = await runUnitTests(client.http, client.safety, objectUrl);
+            return textResult(JSON.stringify(results, null, 2));
+        }
+        case 'atc': {
+            const objectUrl = objectUrlForType(type, name);
+            const variant = args.variant;
+            const result = await runAtcCheck(client.http, client.safety, objectUrl, variant);
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        case 'cds_testcases': {
+            // SAP-suggested ABAP Unit test cases for a CDS entity (CDS Test Double Framework).
+            // The CDS name goes straight into the ?ddlsourceName= query param — no object URL.
+            if (!name) {
+                return errorResult('"name" (the CDS entity / DDLS source name) is required for "cds_testcases".');
+            }
+            // Discovery-gate: the endpoint exists only on SAP_BASIS 8.16+ (ABAP Platform 2025).
+            // `false` = discovery loaded and the collection is absent (7.5x / 758) → clear message.
+            // `undefined` = discovery not loaded → attempt and let a 404/400 surface normally.
+            if (supportsCdsTestCases(client.http) === false) {
+                return errorResult('CDS test-case scaffolding requires SAP_BASIS 8.16+ (ABAP Platform 2025 / S/4HANA 2025). ' +
+                    'This system does not expose /sap/bc/adt/aunit/dbtestdoubles/cds/testcases.');
+            }
+            const result = await getCdsTestCases(client.http, client.safety, name);
+            const payload = {
+                ...result,
+                hint: `Scaffold an ABAP Unit test class for ${result.cds}: ` +
+                    `cl_cds_test_environment=>create( i_for_entity = '${result.cds}' ) in class_setup, ` +
+                    'then implement one FOR TESTING method per case (insert_test_data for the doubled sources, ' +
+                    'assert with cl_abap_unit_assert). AI testdata/testmethod generation is not exposed.',
+            };
+            return textResult(JSON.stringify(payload, null, 2));
+        }
+        case 'object_state': {
+            if (!name || !type)
+                return errorResult('"name" and "type" are required for "object_state" action.');
+            const sections = type === 'CLAS'
+                ? [
+                    { section: 'main', uri: sourceUrlForType(type, name) },
+                    { section: 'definitions', uri: classIncludeUrl(name, 'definitions'), optional: true },
+                    { section: 'implementations', uri: classIncludeUrl(name, 'implementations'), optional: true },
+                    { section: 'macros', uri: classIncludeUrl(name, 'macros'), optional: true },
+                    { section: 'testclasses', uri: classIncludeUrl(name, 'testclasses'), optional: true },
+                ]
+                : [{ section: 'main', uri: sourceUrlForType(type, name) }];
+            const result = await getObjectState(client.http, client.safety, { type, name, sections });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        case 'quickfix': {
+            const source = args.source;
+            const sourceUri = args.sourceUri;
+            if (!name || !type)
+                return errorResult('"name" and "type" are required for "quickfix" action.');
+            if (!source)
+                return errorResult('"source" is required for "quickfix" action.');
+            if (args.line == null)
+                return errorResult('"line" is required for "quickfix" action.');
+            const line = Number(args.line);
+            const column = Number(args.column ?? 0);
+            if (!Number.isFinite(line))
+                return errorResult('"line" must be a number for "quickfix" action.');
+            if (!Number.isFinite(column))
+                return errorResult('"column" must be a number for "quickfix" action.');
+            const proposals = await getFixProposals(client.http, client.safety, sourceUri ?? sourceUrlForType(type, name), source, line, column);
+            return textResult(JSON.stringify(proposals, null, 2));
+        }
+        case 'apply_quickfix': {
+            const source = args.source;
+            const sourceUri = args.sourceUri;
+            const proposalUri = args.proposalUri;
+            const proposalUserContent = args.proposalUserContent;
+            const proposalAffectedObjects = args.proposalAffectedObjects;
+            if (!name || !type)
+                return errorResult('"name" and "type" are required for "apply_quickfix" action.');
+            if (!source)
+                return errorResult('"source" is required for "apply_quickfix" action.');
+            if (args.line == null)
+                return errorResult('"line" is required for "apply_quickfix" action.');
+            if (!proposalUri)
+                return errorResult('"proposalUri" is required for "apply_quickfix" action.');
+            if (proposalUserContent === undefined)
+                return errorResult('"proposalUserContent" is required for "apply_quickfix" action.');
+            const line = Number(args.line);
+            const column = Number(args.column ?? 0);
+            if (!Number.isFinite(line))
+                return errorResult('"line" must be a number for "apply_quickfix" action.');
+            if (!Number.isFinite(column))
+                return errorResult('"column" must be a number for "apply_quickfix" action.');
+            const deltas = await applyFixProposal(client.http, client.safety, {
+                uri: proposalUri,
+                type: 'quickfix/proposal',
+                name: '',
+                description: '',
+                userContent: proposalUserContent,
+                ...(proposalAffectedObjects ? { affectedObjects: proposalAffectedObjects } : {}),
+            }, sourceUri ?? sourceUrlForType(type, name), source, line, column);
+            return textResult(JSON.stringify(deltas, null, 2));
+        }
+        case 'dumps': {
+            const id = args.id;
+            if (id) {
+                const detail = await getDump(client.http, client.safety, id);
+                const includeFullText = args.includeFullText === true || String(args.includeFullText ?? '') === 'true';
+                const selectedSections = selectDumpSections(detail, args.sections);
+                const payload = {
+                    id: detail.id,
+                    error: detail.error,
+                    exception: detail.exception,
+                    program: detail.program,
+                    user: detail.user,
+                    timestamp: detail.timestamp,
+                    chapters: detail.chapters,
+                    terminationUri: detail.terminationUri,
+                    sections: selectedSections,
+                    selectedSectionIds: Object.keys(selectedSections),
+                    availableSections: detail.chapters.map((chapter) => ({
+                        id: chapter.name,
+                        title: chapter.title,
+                        line: chapter.line,
+                    })),
+                };
+                if (includeFullText) {
+                    payload.formattedText = detail.formattedText;
+                }
+                return textResult(JSON.stringify(payload, null, 2));
+            }
+            const user = args.user;
+            const maxResults = args.maxResults ? Number(args.maxResults) : undefined;
+            const dumps = await listDumps(client.http, client.safety, { user, maxResults });
+            return textResult(JSON.stringify(dumps, null, 2));
+        }
+        case 'traces': {
+            const id = args.id;
+            if (id) {
+                // Get trace analysis
+                const analysis = String(args.analysis ?? 'hitlist');
+                switch (analysis) {
+                    case 'hitlist': {
+                        const hitlist = await getTraceHitlist(client.http, client.safety, id);
+                        return textResult(JSON.stringify(hitlist, null, 2));
+                    }
+                    case 'statements': {
+                        const statements = await getTraceStatements(client.http, client.safety, id);
+                        return textResult(JSON.stringify(statements, null, 2));
+                    }
+                    case 'dbAccesses': {
+                        const dbAccesses = await getTraceDbAccesses(client.http, client.safety, id);
+                        return textResult(JSON.stringify(dbAccesses, null, 2));
+                    }
+                    default:
+                        return errorResult(`Unknown trace analysis type: ${analysis}. Supported: hitlist, statements, dbAccesses`);
+                }
+            }
+            // List traces
+            const traces = await listTraces(client.http, client.safety);
+            return textResult(JSON.stringify(traces, null, 2));
+        }
+        case 'system_messages': {
+            const user = args.user;
+            const maxResults = args.maxResults ? Number(args.maxResults) : undefined;
+            const from = args.from;
+            const to = args.to;
+            const messages = await listSystemMessages(client.http, client.safety, { user, maxResults, from, to });
+            return textResult(JSON.stringify(messages, null, 2));
+        }
+        case 'gateway_errors': {
+            if (isBtpSystem()) {
+                return errorResult('SAP Gateway error log is not available on BTP ABAP Environment. Use this action on on-prem systems.');
+            }
+            const user = args.user;
+            const maxResults = args.maxResults ? Number(args.maxResults) : undefined;
+            const from = args.from;
+            const to = args.to;
+            const detailUrl = args.detailUrl;
+            const id = args.id;
+            const errorType = args.errorType;
+            if (detailUrl || id) {
+                const detail = await getGatewayErrorDetail(client.http, client.safety, { detailUrl, id, errorType });
+                return textResult(JSON.stringify(detail, null, 2));
+            }
+            const errors = await listGatewayErrors(client.http, client.safety, { user, maxResults, from, to });
+            return textResult(JSON.stringify(errors, null, 2));
+        }
+        default:
+            return errorResult(`Unknown SAPDiagnose action: ${action}. Supported: syntax, unittest, atc, object_state, quickfix, apply_quickfix, dumps, traces, system_messages, gateway_errors`);
+    }
+}
+function selectDumpSections(detail, requestedSections) {
+    const availableSections = detail.sections ?? {};
+    const availableIds = Object.keys(availableSections);
+    if (availableIds.length === 0)
+        return {};
+    const requestedIds = resolveRequestedDumpSectionIds(detail, requestedSections);
+    const selectedIds = requestedIds.length > 0 ? requestedIds : pickDefaultDumpSectionIds(detail);
+    const finalIds = selectedIds.length > 0 ? selectedIds : availableIds.slice(0, 5);
+    return Object.fromEntries(finalIds.map((id) => [id, availableSections[id] ?? '']));
+}
+function resolveRequestedDumpSectionIds(detail, requestedSections) {
+    if (!Array.isArray(requestedSections))
+        return [];
+    const availableIds = new Set(Object.keys(detail.sections ?? {}));
+    const resolved = requestedSections
+        .map((entry) => resolveDumpSectionId(detail, String(entry ?? '')))
+        .filter((entry) => typeof entry === 'string' && availableIds.has(entry));
+    return Array.from(new Set(resolved));
+}
+function resolveDumpSectionId(detail, candidate) {
+    const normalizedCandidate = normalizeDumpSectionKey(candidate);
+    if (!normalizedCandidate)
+        return undefined;
+    const direct = detail.chapters.find((chapter) => normalizeDumpSectionKey(chapter.name) === normalizedCandidate)?.name;
+    if (direct)
+        return direct;
+    const exactTitle = detail.chapters.find((chapter) => normalizeDumpSectionKey(chapter.title) === normalizedCandidate)?.name;
+    if (exactTitle)
+        return exactTitle;
+    const fuzzyTitle = detail.chapters.find((chapter) => normalizeDumpSectionKey(chapter.title).includes(normalizedCandidate))?.name;
+    return fuzzyTitle;
+}
+function pickDefaultDumpSectionIds(detail) {
+    const wanted = ['short text', 'what happened', 'error analysis', 'source code extract', 'active calls', 'call stack'];
+    const selected = [];
+    for (const pattern of wanted) {
+        const found = detail.chapters.find((chapter) => normalizeDumpSectionKey(chapter.title).includes(normalizeDumpSectionKey(pattern)) && chapter.name);
+        if (found?.name && !selected.includes(found.name) && detail.sections[found.name]) {
+            selected.push(found.name);
+        }
+    }
+    if (selected.length > 0)
+        return selected;
+    const ordered = [...detail.chapters]
+        .sort((a, b) => {
+        if (a.line !== b.line)
+            return a.line - b.line;
+        return a.chapterOrder - b.chapterOrder;
+    })
+        .map((chapter) => chapter.name)
+        .filter((name) => Boolean(name) && Boolean(detail.sections[name]));
+    return Array.from(new Set(ordered)).slice(0, 5);
+}
+function normalizeDumpSectionKey(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=diagnose.js.map