@mcp-abap-adt/core 6.5.0 → 6.7.0

package/dist/lib/search-source/orchestrator.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSearchSource = runSearchSource;
+exports.runSearchSourceWithContext = runSearchSourceWithContext;
+const lineScanner_1 = require("./lineScanner");
+const packageEnumerator_1 = require("./packageEnumerator");
+const sourceReader_1 = require("./sourceReader");
+const DEFAULTS = {
+    include_subpackages: true,
+    object_types: ['PROG', 'FUGR', 'CLAS'],
+    exclude_comments: false,
+    max_hits_per_object: 1,
+    emit_no_hits: false,
+    max_objects: 500,
+    concurrency: 8,
+    version: 'active',
+};
+async function runWithLimit(items, limit, worker) {
+    let next = 0;
+    async function pump() {
+        while (true) {
+            const idx = next++;
+            if (idx >= items.length)
+                return;
+            await worker(items[idx]);
+        }
+    }
+    const n = Math.max(1, Math.min(limit, items.length));
+    await Promise.all(Array.from({ length: n }, () => pump()));
+}
+async function runSearchSource(deps, input) {
+    if (!input.query || input.query.length === 0) {
+        throw new Error('query must be a non-empty string');
+    }
+    if (!input.packages || input.packages.length === 0) {
+        throw new Error('packages must contain at least one entry');
+    }
+    if (input.exclude && input.exclude.length > 3) {
+        throw new Error('exclude may not contain more than 3 entries');
+    }
+    const maxHits = input.max_hits_per_object ?? DEFAULTS.max_hits_per_object;
+    const maxObjects = input.max_objects ?? DEFAULTS.max_objects;
+    const concurrency = Math.min(16, Math.max(1, input.concurrency ?? DEFAULTS.concurrency));
+    const emitNoHits = input.emit_no_hits ?? DEFAULTS.emit_no_hits;
+    const version = input.version ?? DEFAULTS.version;
+    const enumerateInput = {
+        packages: input.packages,
+        include_subpackages: input.include_subpackages ?? DEFAULTS.include_subpackages,
+        object_filter: input.object_filter,
+        object_types: input.object_types ?? DEFAULTS.object_types,
+    };
+    const allTargets = await (0, packageEnumerator_1.enumerateScanTargets)(deps.fetchPackageContents, enumerateInput);
+    const truncatedByMaxObjects = allTargets.length > maxObjects;
+    const targets = truncatedByMaxObjects
+        ? allTargets.slice(0, maxObjects)
+        : allTargets;
+    const allHits = [];
+    const noHits = [];
+    let sourcesScanned = 0;
+    let truncatedByObjectCap = false;
+    await runWithLimit(targets, concurrency, async (target) => {
+        let totalForTarget = 0;
+        let capHitForTarget = false;
+        const targetHits = [];
+        for await (const unit of (0, sourceReader_1.readSourceUnits)(deps.sourceReader, target, version)) {
+            sourcesScanned++;
+            const remaining = maxHits - totalForTarget;
+            if (remaining <= 0) {
+                const probe = (0, lineScanner_1.scanLines)(unit.lines, {
+                    query: input.query,
+                    query2: input.query2,
+                    exclude: input.exclude,
+                    exclude_comments: input.exclude_comments,
+                    max_hits: 1,
+                });
+                if (probe.hits.length > 0) {
+                    capHitForTarget = true;
+                    break;
+                }
+                continue;
+            }
+            const scan = (0, lineScanner_1.scanLines)(unit.lines, {
+                query: input.query,
+                query2: input.query2,
+                exclude: input.exclude,
+                exclude_comments: input.exclude_comments,
+                max_hits: remaining,
+            });
+            for (const h of scan.hits) {
+                targetHits.push({
+                    devclass: target.devclass,
+                    object_type: target.object_type,
+                    object_name: target.object_name,
+                    include: unit.include,
+                    line: h.line,
+                    snippet: h.snippet,
+                });
+            }
+            totalForTarget += scan.hits.length;
+            if (scan.capped) {
+                capHitForTarget = true;
+                break;
+            }
+        }
+        if (capHitForTarget)
+            truncatedByObjectCap = true;
+        if (targetHits.length === 0 && emitNoHits) {
+            noHits.push({
+                devclass: target.devclass,
+                object_type: target.object_type,
+                object_name: target.object_name,
+            });
+        }
+        else {
+            allHits.push(...targetHits);
+        }
+    });
+    allHits.sort((a, b) => {
+        if (a.devclass !== b.devclass)
+            return a.devclass < b.devclass ? -1 : 1;
+        if (a.object_name !== b.object_name)
+            return a.object_name < b.object_name ? -1 : 1;
+        if (a.include !== b.include)
+            return a.include < b.include ? -1 : 1;
+        return a.line - b.line;
+    });
+    if (emitNoHits) {
+        noHits.sort((a, b) => {
+            if (a.devclass !== b.devclass)
+                return a.devclass < b.devclass ? -1 : 1;
+            if (a.object_type !== b.object_type)
+                return a.object_type < b.object_type ? -1 : 1;
+            return a.object_name < b.object_name ? -1 : 1;
+        });
+    }
+    const result = {
+        results: allHits,
+        scanned: {
+            packages: input.packages.length,
+            objects: targets.length,
+            sources: sourcesScanned,
+        },
+        truncated: {
+            by_object_cap: truncatedByObjectCap,
+            by_max_objects: truncatedByMaxObjects,
+        },
+    };
+    if (emitNoHits)
+        result.no_hits = noHits;
+    return result;
+}
+function runSearchSourceWithContext(ctx, input) {
+    return runSearchSource({
+        fetchPackageContents: (0, packageEnumerator_1.createPackageContentsFetcher)(ctx),
+        sourceReader: (0, sourceReader_1.createSourceReaderDeps)(ctx),
+    }, input);
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/lib/search-source/orchestrator.js.map

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

package/dist/lib/search-source/packageEnumerator.d.ts

@@ -0,0 +1,25 @@
+import type { HandlerContext } from '../handlers/interfaces';
+export type ScanObjectType = 'PROG' | 'FUGR' | 'CLAS';
+export interface PackageContentItem {
+    name: string;
+    adtType: string;
+    packageName: string;
+    isPackage: boolean;
+}
+export interface EnumeratedObject {
+    devclass: string;
+    object_type: ScanObjectType;
+    object_name: string;
+}
+export interface EnumerateInput {
+    packages: string[];
+    include_subpackages: boolean;
+    object_filter?: string;
+    object_types: readonly ScanObjectType[];
+}
+export type PackageContentsFetcher = (packageName: string, options: {
+    includeSubpackages: boolean;
+}) => Promise<PackageContentItem[]>;
+export declare function enumerateScanTargets(fetch: PackageContentsFetcher, input: EnumerateInput): Promise<EnumeratedObject[]>;
+export declare function createPackageContentsFetcher(ctx: HandlerContext): PackageContentsFetcher;
+//# sourceMappingURL=packageEnumerator.d.ts.map

package/dist/lib/search-source/packageEnumerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageEnumerator.d.ts","sourceRoot":"","sources":["../../../src/lib/search-source/packageEnumerator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;CACzC;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,KACrC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAkBnC,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,sBAAsB,EAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoC7B;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,cAAc,GAClB,sBAAsB,CAOxB"}

package/dist/lib/search-source/packageEnumerator.js.map

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

package/dist/lib/search-source/sourceReader.d.ts

@@ -0,0 +1,25 @@
+import type { HandlerContext } from '../handlers/interfaces';
+import type { EnumeratedObject } from './packageEnumerator';
+export type SourceVersion = 'active' | 'inactive';
+export interface SourceUnit {
+    include: string;
+    lines: string[];
+}
+export interface FugrChild {
+    objecttype: string;
+    objectname: string;
+}
+export interface ReadSourceUnitsDeps {
+    readProgram(programName: string, version: SourceVersion): Promise<string | null>;
+    readInclude(includeName: string): Promise<string | null>;
+    readClassMain(className: string, version: SourceVersion): Promise<string | null>;
+    fetchFugrStructure(fugrName: string): Promise<FugrChild[]>;
+    readFugrFm(fugrName: string, fmName: string): Promise<string | null>;
+    logger?: {
+        debug?: (msg: string) => void;
+        warn?: (msg: string) => void;
+    };
+}
+export declare function readSourceUnits(deps: ReadSourceUnitsDeps, target: EnumeratedObject, version?: SourceVersion): AsyncGenerator<SourceUnit>;
+export declare function createSourceReaderDeps(ctx: HandlerContext): ReadSourceUnitsDeps;
+//# sourceMappingURL=sourceReader.d.ts.map

package/dist/lib/search-source/sourceReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceReader.d.ts","sourceRoot":"","sources":["../../../src/lib/search-source/sourceReader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,qBAAqB,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,CACT,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACrE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CAC1E;AA+BD,wBAAuB,eAAe,CACpC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,aAAwB,GAChC,cAAc,CAAC,UAAU,CAAC,CA+D5B;AA6BD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,GAClB,mBAAmB,CAuCrB"}

package/dist/lib/search-source/sourceReader.js

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readSourceUnits = readSourceUnits;
+exports.createSourceReaderDeps = createSourceReaderDeps;
+const fast_xml_parser_1 = require("fast-xml-parser");
+const clients_1 = require("../clients");
+const utils_1 = require("../utils");
+function splitLines(text) {
+    return text.split(/\r?\n/);
+}
+async function safe(op, logger, desc) {
+    try {
+        return await op();
+    }
+    catch (e) {
+        logger?.debug?.(`[search-source] ${desc} failed: ${e?.message ?? e}`);
+        return null;
+    }
+}
+function isViewFm(name) {
+    return name.length >= 4 && name.slice(0, 4).toUpperCase() === 'VIEW';
+}
+function sortFugrChildren(children) {
+    return [...children].sort((a, b) => {
+        if (a.objecttype !== b.objecttype)
+            return a.objecttype < b.objecttype ? -1 : 1;
+        return a.objectname < b.objectname ? -1 : 1;
+    });
+}
+async function* readSourceUnits(deps, target, version = 'active') {
+    const logger = deps.logger;
+    switch (target.object_type) {
+        case 'PROG': {
+            const src = await safe(() => deps.readProgram(target.object_name, version), logger, `read PROG ${target.object_name}`);
+            if (src !== null && src !== undefined) {
+                yield { include: target.object_name, lines: splitLines(src) };
+            }
+            return;
+        }
+        case 'CLAS': {
+            const src = await safe(() => deps.readClassMain(target.object_name, version), logger, `read CLAS ${target.object_name}`);
+            if (src !== null && src !== undefined) {
+                yield { include: target.object_name, lines: splitLines(src) };
+            }
+            return;
+        }
+        case 'FUGR': {
+            const children = await safe(() => deps.fetchFugrStructure(target.object_name), logger, `fetch FUGR structure ${target.object_name}`);
+            if (!children)
+                return;
+            const seen = new Set();
+            const filtered = [];
+            for (const c of children) {
+                if (c.objecttype === 'FUGR/FF' && isViewFm(c.objectname))
+                    continue;
+                if (!c.objecttype.startsWith('FUGR/'))
+                    continue;
+                const key = `${c.objecttype}|${c.objectname}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                filtered.push(c);
+            }
+            const ordered = sortFugrChildren(filtered);
+            for (const c of ordered) {
+                const src = c.objecttype === 'FUGR/FF'
+                    ? await safe(() => deps.readFugrFm(target.object_name, c.objectname), logger, `read FUGR/FF ${target.object_name}/${c.objectname}`)
+                    : await safe(() => deps.readInclude(c.objectname), logger, `read FUGR include ${c.objectname}`);
+                if (src !== null && src !== undefined) {
+                    yield { include: c.objectname, lines: splitLines(src) };
+                }
+            }
+            return;
+        }
+    }
+}
+function parseFugrChildrenFromXml(xml) {
+    const parser = new fast_xml_parser_1.XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '',
+    });
+    const parsed = parser.parse(xml);
+    let nodes = parsed?.['projectexplorer:objectstructure']?.['projectexplorer:node'];
+    if (!nodes)
+        return [];
+    if (!Array.isArray(nodes))
+        nodes = [nodes];
+    const out = [];
+    for (const node of nodes) {
+        if (!node.objecttype || !node.objectname)
+            continue;
+        if (!node.objecttype.startsWith('FUGR/'))
+            continue;
+        out.push({ objecttype: node.objecttype, objectname: node.objectname });
+    }
+    return out;
+}
+function createSourceReaderDeps(ctx) {
+    const client = (0, clients_1.createAdtClient)(ctx.connection, ctx.logger);
+    return {
+        async readProgram(programName, version) {
+            const r = await client.getProgram().read({ programName }, version);
+            const data = r?.readResult?.data;
+            return typeof data === 'string' ? data : null;
+        },
+        async readInclude(includeName) {
+            const r = await (0, utils_1.makeAdtRequestWithTimeout)(ctx.connection, `/sap/bc/adt/programs/includes/${(0, utils_1.encodeSapObjectName)(includeName)}/source/main`, 'GET', 'default');
+            return typeof r?.data === 'string' ? r.data : null;
+        },
+        async readClassMain(className, version) {
+            const r = await client.getClass().read({ className }, version);
+            const data = r?.readResult?.data;
+            return typeof data === 'string' ? data : null;
+        },
+        async fetchFugrStructure(fugrName) {
+            const r = await client.getUtils().getObjectStructure('FUGR/F', fugrName);
+            return typeof r?.data === 'string'
+                ? parseFugrChildrenFromXml(r.data)
+                : [];
+        },
+        async readFugrFm(fugrName, fmName) {
+            const r = await (0, utils_1.makeAdtRequestWithTimeout)(ctx.connection, `/sap/bc/adt/functions/groups/${(0, utils_1.encodeSapObjectName)(fugrName.toLowerCase())}/fmodules/${(0, utils_1.encodeSapObjectName)(fmName.toLowerCase())}/source/main`, 'GET', 'default');
+            return typeof r?.data === 'string' ? r.data : null;
+        },
+        logger: ctx.logger,
+    };
+}
+//# sourceMappingURL=sourceReader.js.map

package/dist/lib/search-source/sourceReader.js.map

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

package/docs/user-guide/AVAILABLE_TOOLS.md

@@ -4,8 +4,8 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ## Summary
 
-- Total tools: 304
-- Read-only tools: 53
+- Total tools: 307
+- Read-only tools: 56
 - High-level tools: 127
 - Low-level tools: 124
 
@@ -86,8 +86,11 @@ Generated from code in `src/handlers/**` (not from docs).
     - [RuntimeListFeeds](#runtimelistfeeds-read-only-system)
     - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
     - [RuntimeListSystemMessages](#runtimelistsystemmessages-read-only-system)
+    - [RuntimeRunClass](#runtimerunclass-read-only-system)
     - [RuntimeRunClassWithProfiling](#runtimerunclasswithprofiling-read-only-system)
+    - [RuntimeRunProgram](#runtimerunprogram-read-only-system)
     - [RuntimeRunProgramWithProfiling](#runtimerunprogramwithprofiling-read-only-system)
+    - [SearchSource](#searchsource-read-only-system)
   - [Table](#read-only-table)
     - [GetTableContents](#gettablecontents-read-only-table)
     - [ReadTable](#readtable-read-only-table)
@@ -1033,9 +1036,38 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimerunclass-read-only-system"></a>
+#### RuntimeRunClass (Read-Only / System)
+**Description:** [runtime] Execute an ABAP class implementing if_oo_adt_classrun and return its output. Set profile=true to also capture a profiler trace (returns profilerId/traceId alongside output).
+
+**Source:** `src/handlers/system/readonly/handleRuntimeRunClass.ts`
+
+**Parameters:**
+- `aggregate` (boolean, optional) - 
+- `all_db_events` (boolean, optional) - 
+- `all_dynpro_events` (boolean, optional) - 
+- `all_internal_table_events` (boolean, optional) - 
+- `all_misc_abap_statements` (boolean, optional) - 
+- `all_procedural_units` (boolean, optional) - 
+- `all_system_kernel_events` (boolean, optional) - 
+- `amdp_trace` (boolean, optional) - 
+- `class_name` (string, required) - ABAP class name to execute.
+- `description` (string, optional) - Profiler trace description (only used when profile=true).
+- `explicit_on_off` (boolean, optional) - 
+- `max_size_for_trace_file` (number, optional) - 
+- `max_time_for_tracing` (number, optional) - 
+- `max_trace_attempts` (integer, optional) - Max polling attempts to resolve traceId after execution (default 5). Only used when profile=true.
+- `profile` (boolean, optional) - When true, run with the profiler and resolve the resulting traceId. Default false.
+- `sql_trace` (boolean, optional) - 
+- `trace_lookup_uris` (array, optional) - Additional URIs to consult when resolving the trace (advanced, profile=true).
+- `trace_retry_delay_ms` (integer, optional) - Delay in ms between trace polling attempts (default 2000). Only used when profile=true.
+- `with_rfc_tracing` (boolean, optional) - 
+
+---
+
 <a id="runtimerunclasswithprofiling-read-only-system"></a>
 #### RuntimeRunClassWithProfiling (Read-Only / System)
-**Description:** [runtime] Execute ABAP class with profiler enabled and return created profilerId + traceId.
+**Description:** [runtime][deprecated] Execute ABAP class with profiler enabled and return created profilerId + traceId. Prefer RuntimeRunClass with profile=true; this tool is kept for backward compatibility and will be removed in a future major release.
 
 **Source:** `src/handlers/system/readonly/handleRuntimeRunClassWithProfiling.ts`
 
@@ -1053,6 +1085,35 @@ Generated from code in `src/handlers/**` (not from docs).
 - `explicit_on_off` (boolean, optional) - 
 - `max_size_for_trace_file` (number, optional) - 
 - `max_time_for_tracing` (number, optional) - 
+- `max_trace_attempts` (integer, optional) - Max polling attempts to resolve traceId after execution (default 5). Increase for slow systems (e.g. SAP trial cloud).
+- `sql_trace` (boolean, optional) - 
+- `trace_lookup_uris` (array, optional) - Additional URIs to consult when resolving the trace (advanced).
+- `trace_retry_delay_ms` (integer, optional) - Delay in ms between trace polling attempts (default 2000).
+- `with_rfc_tracing` (boolean, optional) - 
+
+---
+
+<a id="runtimerunprogram-read-only-system"></a>
+#### RuntimeRunProgram (Read-Only / System)
+**Description:** [runtime] Execute an ABAP program (report) and return its output. Set profile=true to also start a profiler trace; use RuntimeListProfilerTraceFiles afterwards to locate the trace (program execution is fire-and-forget, so traceId is not returned synchronously).
+
+**Source:** `src/handlers/system/readonly/handleRuntimeRunProgram.ts`
+
+**Parameters:**
+- `aggregate` (boolean, optional) - 
+- `all_db_events` (boolean, optional) - 
+- `all_dynpro_events` (boolean, optional) - 
+- `all_internal_table_events` (boolean, optional) - 
+- `all_misc_abap_statements` (boolean, optional) - 
+- `all_procedural_units` (boolean, optional) - 
+- `all_system_kernel_events` (boolean, optional) - 
+- `amdp_trace` (boolean, optional) - 
+- `description` (string, optional) - Profiler trace description (only used when profile=true).
+- `explicit_on_off` (boolean, optional) - 
+- `max_size_for_trace_file` (number, optional) - 
+- `max_time_for_tracing` (number, optional) - 
+- `profile` (boolean, optional) - When true, run with the profiler. Default false. Trace must be located afterwards via RuntimeListProfilerTraceFiles — program execution does not return traceId synchronously.
+- `program_name` (string, required) - ABAP program name to execute.
 - `sql_trace` (boolean, optional) - 
 - `with_rfc_tracing` (boolean, optional) - 
 
@@ -1060,7 +1121,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="runtimerunprogramwithprofiling-read-only-system"></a>
 #### RuntimeRunProgramWithProfiling (Read-Only / System)
-**Description:** [runtime] Execute ABAP program with profiler enabled and return created profilerId + traceId.
+**Description:** [runtime][deprecated] Execute ABAP program with profiler enabled and return created profilerId. Prefer RuntimeRunProgram with profile=true; this tool is kept for backward compatibility and will be removed in a future major release.
 
 **Source:** `src/handlers/system/readonly/handleRuntimeRunProgramWithProfiling.ts`
 
@@ -1083,6 +1144,17 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="searchsource-read-only-system"></a>
+#### SearchSource (Read-Only / System)
+**Description:** [read-only] Search ABAP source text inside one or more packages (programs, function groups, classes). Onprem-only (cloud lacks an indexed source-search endpoint). Comments are searched by default; set exclude_comments=true to drop col-1 `*` and full-line `
+
+**Source:** `src/handlers/system/readonly/handleSearchSource.ts`
+
+**Parameters:**
+- None
+
+---
+
 <a id="read-only-table"></a>
 ### Read-Only / Table
 
@@ -4879,4 +4951,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-14*

package/docs/user-guide/AVAILABLE_TOOLS_COMPACT.md

@@ -550,4 +550,4 @@ Preferred dedicated compact tools and minimal payloads:
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-14*

package/docs/user-guide/AVAILABLE_TOOLS_HIGH.md

@@ -2049,4 +2049,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-14*

package/docs/user-guide/AVAILABLE_TOOLS_LEGACY.md

@@ -5,8 +5,8 @@ Generated from code in `src/handlers/**` (not from docs).
 Tools available on legacy SAP systems (BASIS < 7.50).
 Legacy systems support a subset of tools — primarily Class, Interface, View, Program, Function Group/Module, Package (read/update/delete), Include, Unit Test, and common utilities.
 
-- Total tools: 129
-- Read-Only: 11
+- Total tools: 130
+- Read-Only: 12
 - High-Level: 58
 - Low-Level: 60
 
@@ -30,6 +30,8 @@ Legacy systems support a subset of tools — primarily Class, Interface, View, P
   - [Program](#read-only-program)
     - [GetProgFullCode](#getprogfullcode-read-only-program)
     - [ReadProgram](#readprogram-read-only-program)
+  - [System](#read-only-system)
+    - [SearchSource](#searchsource-read-only-system)
   - [View](#read-only-view)
     - [ReadView](#readview-read-only-view)
 - [High-Level Group](#high-level-group)
@@ -337,6 +339,22 @@ Legacy systems support a subset of tools — primarily Class, Interface, View, P
 
 ---
 
+<a id="read-only-system"></a>
+### Read-Only / System
+
+<a id="searchsource-read-only-system"></a>
+#### SearchSource (Read-Only / System)
+**Description:** [read-only] Search ABAP source text inside one or more packages (programs, function groups, classes). Onprem-only (cloud lacks an indexed source-search endpoint). Comments are searched by default; set exclude_comments=true to drop col-1 `*` and full-line `
+
+**Source:** `src/handlers/system/readonly/handleSearchSource.ts`
+
+**Available in:** `onprem`, `legacy`
+
+**Parameters:**
+- None
+
+---
+
 <a id="read-only-view"></a>
 ### Read-Only / View
 
@@ -2253,4 +2271,4 @@ Legacy systems support a subset of tools — primarily Class, Interface, View, P
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-14*

package/docs/user-guide/AVAILABLE_TOOLS_LOW.md

@@ -1992,4 +1992,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-14*