@mcp-abap-adt/core 6.5.1 → 6.8.0

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/packageResolver.d.ts

@@ -0,0 +1,13 @@
+import type { HandlerContext } from '../handlers/interfaces';
+export interface SearchObjectsArgs {
+    query: string;
+    objectType: 'DEVC';
+    maxResults: number;
+}
+export type SearchObjectsFn = (args: SearchObjectsArgs) => Promise<string[]>;
+export interface PackageResolverDeps {
+    searchObjects: SearchObjectsFn;
+}
+export declare function resolvePackagePatterns(deps: PackageResolverDeps, entries: string[]): Promise<string[]>;
+export declare function createPackagePatternResolver(ctx: HandlerContext): SearchObjectsFn;
+//# sourceMappingURL=packageResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageResolver.d.ts","sourceRoot":"","sources":["../../../src/lib/search-source/packageResolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,eAAe,CAAC;CAChC;AAQD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBnB;AAED,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,cAAc,GAClB,eAAe,CAyBjB"}

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePackagePatterns = resolvePackagePatterns;
+exports.createPackagePatternResolver = createPackagePatternResolver;
+const clients_1 = require("../clients");
+const WILDCARD_RE = /[*+]/;
+function isPattern(entry) {
+    return WILDCARD_RE.test(entry);
+}
+async function resolvePackagePatterns(deps, entries) {
+    const exact = [];
+    const resolved = [];
+    for (const entry of entries) {
+        if (isPattern(entry)) {
+            const names = await deps.searchObjects({
+                query: entry,
+                objectType: 'DEVC',
+                maxResults: 1000,
+            });
+            resolved.push(...names);
+        }
+        else {
+            exact.push(entry);
+        }
+    }
+    const seen = new Set();
+    const out = [];
+    for (const name of [...exact, ...resolved]) {
+        const key = name.toUpperCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(name);
+    }
+    return out;
+}
+function createPackagePatternResolver(ctx) {
+    const client = (0, clients_1.createAdtClient)(ctx.connection, ctx.logger);
+    const utils = client.getUtils();
+    return async ({ query, objectType, maxResults }) => {
+        const response = await utils.searchObjects({
+            query,
+            objectType,
+            maxResults,
+        });
+        const status = response?.status;
+        if (status && status !== 200) {
+            throw new Error(`ADT request failed (status ${status})`);
+        }
+        const xml = typeof response?.data === 'string'
+            ? response.data
+            : String(response?.data ?? '');
+        const names = [];
+        for (const m of xml.matchAll(/<adtcore:objectReference\s+([^>]*)\/>/g)) {
+            const attrs = m[1];
+            const name = attrs.match(/adtcore:name="([^"]*)"/)?.[1];
+            if (name)
+                names.push(name);
+        }
+        return names;
+    };
+}
+//# sourceMappingURL=packageResolver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageResolver.js","sourceRoot":"","sources":["../../../src/lib/search-source/packageResolver.ts"],"names":[],"mappings":";;AAqBA,wDA2BC;AAED,oEA2BC;AA7ED,wCAA6C;AAe7C,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,IAAyB,EACzB,OAAiB;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC;gBACrC,KAAK,EAAE,KAAK;gBACZ,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,4BAA4B,CAC1C,GAAmB;IAEnB,MAAM,MAAM,GAAG,IAAA,yBAAe,EAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAChC,OAAO,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE;QACjD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC;YACzC,KAAK;YACL,UAAU;YACV,UAAU;SACX,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC;QAChC,IAAI,MAAM,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,GAAG,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,GACP,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ;YAChC,CAAC,CAAC,QAAQ,CAAC,IAAI;YACf,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,wCAAwC,CAAC,EAAE,CAAC;YACvE,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxD,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

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). `packages` accepts `*` masks (Z*, ZFI_*, /NS/Z*) alongside exact names; mask resolution is best-effort and scoped to the ADT repository-search result window — there is no guarantee that every matching package is scanned. If you need certainty, pass concrete package names. When using masks, narrow the mask itself and use `object_types`, `object_filter`, and `max_objects` as scan-target controls that apply after package resolution. 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-15*

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-15*

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-15*

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). `packages` accepts `*` masks (Z*, ZFI_*, /NS/Z*) alongside exact names; mask resolution is best-effort and scoped to the ADT repository-search result window — there is no guarantee that every matching package is scanned. If you need certainty, pass concrete package names. When using masks, narrow the mask itself and use `object_types`, `object_filter`, and `max_objects` as scan-target controls that apply after package resolution. 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-15*

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-15*

package/docs/user-guide/AVAILABLE_TOOLS_READONLY.md

@@ -3,7 +3,7 @@
 Generated from code in `src/handlers/**` (not from docs).
 
 - Level: Read-Only
-- Total tools: 53
+- Total tools: 56
 
 ## Navigation
 
@@ -72,8 +72,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)
@@ -725,9 +728,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`
 
@@ -745,6 +777,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) - 
 
@@ -752,7 +813,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`
 
@@ -775,6 +836,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). `packages` accepts `*` masks (Z*, ZFI_*, /NS/Z*) alongside exact names; mask resolution is best-effort and scoped to the ADT repository-search result window — there is no guarantee that every matching package is scanned. If you need certainty, pass concrete package names. When using masks, narrow the mask itself and use `object_types`, `object_filter`, and `max_objects` as scan-target controls that apply after package resolution. 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
 
@@ -844,4 +916,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-04-24*
+*Last updated: 2026-05-15*