@mcp-abap-adt/core 4.8.1 → 4.8.3

package/dist/src/handlers/system/low/handleGetObjectStructure.d.ts

@@ -0,0 +1,69 @@
+/**
+ * GetObjectStructure Handler - Low-level handler for object structure
+ *
+ * Uses getObjectStructure from @mcp-abap-adt/adt-clients AdtUtils.
+ * Retrieves ADT object structure as compact JSON tree.
+ */
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "GetObjectStructureLow";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[low-level] Retrieve ADT object structure as compact JSON tree. Returns XML response with object structure tree. Can use session_id and session_state from GetSession to maintain the same session.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly object_type: {
+                readonly type: "string";
+                readonly description: "Object type (e.g., \"CLAS/OC\", \"PROG/P\", \"DEVC/K\", \"DDLS/DF\")";
+            };
+            readonly object_name: {
+                readonly type: "string";
+                readonly description: "Object name (e.g., \"ZMY_CLASS\", \"ZMY_PROGRAM\")";
+            };
+            readonly session_id: {
+                readonly type: "string";
+                readonly description: "Session ID from GetSession. If not provided, a new session will be created.";
+            };
+            readonly session_state: {
+                readonly type: "object";
+                readonly description: "Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.";
+                readonly properties: {
+                    readonly cookies: {
+                        readonly type: "string";
+                    };
+                    readonly csrf_token: {
+                        readonly type: "string";
+                    };
+                    readonly cookie_store: {
+                        readonly type: "object";
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["object_type", "object_name"];
+    };
+};
+interface GetObjectStructureArgs {
+    object_type: string;
+    object_name: string;
+    session_id?: string;
+    session_state?: {
+        cookies?: string;
+        csrf_token?: string;
+        cookie_store?: Record<string, string>;
+    };
+}
+/**
+ * Main handler for GetObjectStructureLow MCP tool
+ *
+ * Uses getObjectStructure from AdtUtils
+ */
+export declare function handleGetObjectStructure(context: HandlerContext, args: GetObjectStructureArgs): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: any;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=handleGetObjectStructure.d.ts.map

package/dist/src/handlers/system/low/handleGetObjectStructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetObjectStructure.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/system/low/handleGetObjectStructure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmClB,CAAC;AAEX,UAAU,sBAAsB;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,sBAAsB;;;;;;GA8C7B"}

package/dist/src/handlers/system/low/handleGetObjectStructure.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * GetObjectStructure Handler - Low-level handler for object structure
+ *
+ * Uses getObjectStructure from @mcp-abap-adt/adt-clients AdtUtils.
+ * Retrieves ADT object structure as compact JSON tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleGetObjectStructure = handleGetObjectStructure;
+const clients_1 = require("../../../lib/clients");
+const utils_1 = require("../../../lib/utils");
+exports.TOOL_DEFINITION = {
+    name: 'GetObjectStructureLow',
+    available_in: ['onprem', 'cloud'],
+    description: '[low-level] Retrieve ADT object structure as compact JSON tree. Returns XML response with object structure tree. Can use session_id and session_state from GetSession to maintain the same session.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            object_type: {
+                type: 'string',
+                description: 'Object type (e.g., "CLAS/OC", "PROG/P", "DEVC/K", "DDLS/DF")',
+            },
+            object_name: {
+                type: 'string',
+                description: 'Object name (e.g., "ZMY_CLASS", "ZMY_PROGRAM")',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session ID from GetSession. If not provided, a new session will be created.',
+            },
+            session_state: {
+                type: 'object',
+                description: 'Session state from GetSession (cookies, csrf_token, cookie_store). Required if session_id is provided.',
+                properties: {
+                    cookies: { type: 'string' },
+                    csrf_token: { type: 'string' },
+                    cookie_store: { type: 'object' },
+                },
+            },
+        },
+        required: ['object_type', 'object_name'],
+    },
+};
+/**
+ * Main handler for GetObjectStructureLow MCP tool
+ *
+ * Uses getObjectStructure from AdtUtils
+ */
+async function handleGetObjectStructure(context, args) {
+    const { connection, logger } = context;
+    try {
+        // Validate required parameters
+        if (!args?.object_type) {
+            return (0, utils_1.return_error)(new Error('object_type is required'));
+        }
+        if (!args?.object_name) {
+            return (0, utils_1.return_error)(new Error('object_name is required'));
+        }
+        // Restore session state if provided
+        if (args.session_id && args.session_state) {
+            const { restoreSessionInConnection } = await import('../../../lib/utils.js');
+            await restoreSessionInConnection(connection, args.session_id, args.session_state);
+        }
+        // Create AdtClient and get utilities
+        const client = (0, clients_1.createAdtClient)(connection, logger);
+        const utils = client.getUtils();
+        logger?.info(`Fetching object structure for ${args.object_type}/${args.object_name}`);
+        const result = await utils.getObjectStructure(args.object_type, args.object_name);
+        logger?.debug(`Object structure fetched successfully for ${args.object_type}/${args.object_name}`);
+        return (0, utils_1.return_response)(result);
+    }
+    catch (error) {
+        logger?.error('Failed to fetch object structure', error);
+        return (0, utils_1.return_error)(error);
+    }
+}
+//# sourceMappingURL=handleGetObjectStructure.js.map

package/dist/src/handlers/system/low/handleGetObjectStructure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetObjectStructure.js","sourceRoot":"","sources":["../../../../../src/handlers/system/low/handleGetObjectStructure.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2DH,4DAgDC;AAzGD,kDAAuD;AAEvD,8CAAmE;AAEtD,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,uBAAuB;IAC7B,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAU;IAC1C,WAAW,EACT,qMAAqM;IACvM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8DAA8D;aACjE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6EAA6E;aAChF;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,wGAAwG;gBAC1G,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACjC;aACF;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC;KACzC;CACO,CAAC;AAaX;;;;GAIG;AACI,KAAK,UAAU,wBAAwB,CAC5C,OAAuB,EACvB,IAA4B;IAE5B,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC;QACH,+BAA+B;QAC/B,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YACvB,OAAO,IAAA,oBAAY,EAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YACvB,OAAO,IAAA,oBAAY,EAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,oCAAoC;QACpC,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1C,MAAM,EAAE,0BAA0B,EAAE,GAAG,MAAM,MAAM,CACjD,uBAAuB,CACxB,CAAC;YACF,MAAM,0BAA0B,CAC9B,UAAU,EACV,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,CACnB,CAAC;QACJ,CAAC;QAED,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAA,yBAAe,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEhC,MAAM,EAAE,IAAI,CACV,iCAAiC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CACxE,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAC3C,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,CACjB,CAAC;QAEF,MAAM,EAAE,KAAK,CACX,6CAA6C,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,EAAE,CACpF,CAAC;QAEF,OAAO,IAAA,uBAAe,EAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/src/handlers/system/low/handleGetVirtualFolders.d.ts

@@ -0,0 +1,86 @@
+/**
+ * GetVirtualFolders Handler - Low-level handler for virtual folders
+ *
+ * Uses getVirtualFoldersContents from @mcp-abap-adt/adt-clients AdtUtils.
+ * Retrieves hierarchical virtual folder contents from ADT information system.
+ */
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "GetVirtualFoldersLow";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[low-level] Retrieve hierarchical virtual folder contents from ADT information system. Used for browsing ABAP objects by package, group, type, etc.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly object_search_pattern: {
+                readonly type: "string";
+                readonly description: "Object search pattern (e.g., \"*\", \"Z*\", \"ZCL_*\"). Default: \"*\"";
+                readonly default: "*";
+            };
+            readonly preselection: {
+                readonly type: "array";
+                readonly description: "Optional preselection filters (facet-value pairs for filtering)";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly facet: {
+                            readonly type: "string";
+                            readonly description: "Facet name (e.g., \"package\", \"group\", \"type\")";
+                        };
+                        readonly values: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                            readonly description: "Array of facet values to filter by";
+                        };
+                    };
+                    readonly required: readonly ["facet", "values"];
+                };
+            };
+            readonly facet_order: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Order of facets in response (e.g., [\"package\", \"group\", \"type\"]). Default: [\"package\", \"group\", \"type\"]";
+                readonly default: readonly ["package", "group", "type"];
+            };
+            readonly with_versions: {
+                readonly type: "boolean";
+                readonly description: "Include version information in response";
+                readonly default: false;
+            };
+            readonly ignore_short_descriptions: {
+                readonly type: "boolean";
+                readonly description: "Ignore short descriptions in response";
+                readonly default: false;
+            };
+        };
+        readonly required: readonly [];
+    };
+};
+interface GetVirtualFoldersArgs {
+    object_search_pattern?: string;
+    preselection?: Array<{
+        facet: string;
+        values: string[];
+    }>;
+    facet_order?: string[];
+    with_versions?: boolean;
+    ignore_short_descriptions?: boolean;
+}
+/**
+ * Main handler for GetVirtualFoldersLow MCP tool
+ *
+ * Uses getVirtualFoldersContents from AdtUtils
+ */
+export declare function handleGetVirtualFolders(context: HandlerContext, args: GetVirtualFoldersArgs): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: any;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=handleGetVirtualFolders.d.ts.map

package/dist/src/handlers/system/low/handleGetVirtualFolders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetVirtualFolders.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/system/low/handleGetVirtualFolders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDlB,CAAC;AAEX,UAAU,qBAAqB;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,qBAAqB;;;;;;GA2B5B"}

package/dist/src/handlers/system/low/handleGetVirtualFolders.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * GetVirtualFolders Handler - Low-level handler for virtual folders
+ *
+ * Uses getVirtualFoldersContents from @mcp-abap-adt/adt-clients AdtUtils.
+ * Retrieves hierarchical virtual folder contents from ADT information system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleGetVirtualFolders = handleGetVirtualFolders;
+const clients_1 = require("../../../lib/clients");
+const utils_1 = require("../../../lib/utils");
+exports.TOOL_DEFINITION = {
+    name: 'GetVirtualFoldersLow',
+    available_in: ['onprem', 'cloud'],
+    description: '[low-level] Retrieve hierarchical virtual folder contents from ADT information system. Used for browsing ABAP objects by package, group, type, etc.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            object_search_pattern: {
+                type: 'string',
+                description: 'Object search pattern (e.g., "*", "Z*", "ZCL_*"). Default: "*"',
+                default: '*',
+            },
+            preselection: {
+                type: 'array',
+                description: 'Optional preselection filters (facet-value pairs for filtering)',
+                items: {
+                    type: 'object',
+                    properties: {
+                        facet: {
+                            type: 'string',
+                            description: 'Facet name (e.g., "package", "group", "type")',
+                        },
+                        values: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Array of facet values to filter by',
+                        },
+                    },
+                    required: ['facet', 'values'],
+                },
+            },
+            facet_order: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Order of facets in response (e.g., ["package", "group", "type"]). Default: ["package", "group", "type"]',
+                default: ['package', 'group', 'type'],
+            },
+            with_versions: {
+                type: 'boolean',
+                description: 'Include version information in response',
+                default: false,
+            },
+            ignore_short_descriptions: {
+                type: 'boolean',
+                description: 'Ignore short descriptions in response',
+                default: false,
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Main handler for GetVirtualFoldersLow MCP tool
+ *
+ * Uses getVirtualFoldersContents from AdtUtils
+ */
+async function handleGetVirtualFolders(context, args) {
+    const { connection, logger } = context;
+    try {
+        // Create AdtClient and get utilities
+        const client = (0, clients_1.createAdtClient)(connection, logger);
+        const utils = client.getUtils();
+        logger?.info('Fetching virtual folders contents');
+        const params = {
+            objectSearchPattern: args.object_search_pattern || '*',
+            preselection: args.preselection,
+            facetOrder: args.facet_order || ['package', 'group', 'type'],
+            withVersions: args.with_versions,
+            ignoreShortDescriptions: args.ignore_short_descriptions,
+        };
+        const result = await utils.getVirtualFoldersContents(params);
+        logger?.debug('Virtual folders contents fetched successfully');
+        return (0, utils_1.return_response)(result);
+    }
+    catch (error) {
+        logger?.error('Failed to fetch virtual folders contents', error);
+        return (0, utils_1.return_error)(error);
+    }
+}
+//# sourceMappingURL=handleGetVirtualFolders.js.map

package/dist/src/handlers/system/low/handleGetVirtualFolders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetVirtualFolders.js","sourceRoot":"","sources":["../../../../../src/handlers/system/low/handleGetVirtualFolders.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA2EH,0DA6BC;AAtGD,kDAAuD;AAEvD,8CAAmE;AAEtD,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,sBAAsB;IAC5B,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAU;IAC1C,WAAW,EACT,qJAAqJ;IACvJ,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,qBAAqB,EAAE;gBACrB,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gEAAgE;gBAClE,OAAO,EAAE,GAAG;aACb;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE,OAAO;gBACb,WAAW,EACT,iEAAiE;gBACnE,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,+CAA+C;yBAC7D;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACzB,WAAW,EAAE,oCAAoC;yBAClD;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;iBAC9B;aACF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yGAAyG;gBAC3G,OAAO,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;aACtC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yCAAyC;gBACtD,OAAO,EAAE,KAAK;aACf;YACD,yBAAyB,EAAE;gBACzB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACO,CAAC;AAUX;;;;GAIG;AACI,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,IAA2B;IAE3B,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC;QACH,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAA,yBAAe,EAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAEhC,MAAM,EAAE,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG;YACb,mBAAmB,EAAE,IAAI,CAAC,qBAAqB,IAAI,GAAG;YACtD,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;YAC5D,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,uBAAuB,EAAE,IAAI,CAAC,yBAAyB;SACxD,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;QAE7D,MAAM,EAAE,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAE/D,OAAO,IAAA,uBAAe,EAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,EAAE,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/src/handlers/system/readonly/handleDescribeByList.d.ts

@@ -0,0 +1,38 @@
+export declare const TOOL_DEFINITION: {
+    readonly name: "DescribeByList";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[read-only] Batch description for a list of ABAP objects. Input: objects: Array<{ name: string, type?: string }>. Each object may be of type: PROG/P, FUGR, PROG/I, CLAS/OC, FUGR/FC, INTF/OI, TABLE, STRUCTURE, etc.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly objects: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly name: {
+                            readonly type: "string";
+                            readonly description: "[read-only] Object name (required, must be valid ABAP object name or mask)";
+                        };
+                        readonly type: {
+                            readonly type: "string";
+                            readonly description: "[read-only] Optional type (e.g. PROG/P, CLAS/OC, etc.)";
+                        };
+                    };
+                };
+            };
+        };
+        readonly required: readonly ["objects"];
+    };
+};
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+/**
+ * DescribeByListArray handler.
+ * @param args { objects: Array<{ name: string, type?: string }> }
+ * @returns Result of handleDetectObjectTypeList with objects
+ */
+export declare function handleDescribeByList(context: HandlerContext, args: any): Promise<{
+    isError: boolean;
+    content: any[];
+}>;
+//# sourceMappingURL=handleDescribeByList.d.ts.map

package/dist/src/handlers/system/readonly/handleDescribeByList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleDescribeByList.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/system/readonly/handleDescribeByList.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlB,CAAC;AAIX,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG;;;GA2G5E"}

package/dist/src/handlers/system/readonly/handleDescribeByList.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_DEFINITION = void 0;
+exports.handleDescribeByList = handleDescribeByList;
+exports.TOOL_DEFINITION = {
+    name: 'DescribeByList',
+    available_in: ['onprem', 'cloud'],
+    description: '[read-only] Batch description for a list of ABAP objects. Input: objects: Array<{ name: string, type?: string }>. Each object may be of type: PROG/P, FUGR, PROG/I, CLAS/OC, FUGR/FC, INTF/OI, TABLE, STRUCTURE, etc.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            objects: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        name: {
+                            type: 'string',
+                            description: '[read-only] Object name (required, must be valid ABAP object name or mask)',
+                        },
+                        type: {
+                            type: 'string',
+                            description: '[read-only] Optional type (e.g. PROG/P, CLAS/OC, etc.)',
+                        },
+                    },
+                },
+            },
+        },
+        required: ['objects'],
+    },
+};
+const handleSearchObject_1 = require("../../search/readonly/handleSearchObject");
+/**
+ * DescribeByListArray handler.
+ * @param args { objects: Array<{ name: string, type?: string }> }
+ * @returns Result of handleDetectObjectTypeList with objects
+ */
+async function handleDescribeByList(context, args) {
+    const { connection, logger } = context;
+    const objects = args?.objects;
+    if (!args || !Array.isArray(objects) || objects.length === 0) {
+        const err = new Error('Missing or invalid parameters: objects (array) is required and must not be empty.');
+        // @ts-expect-error
+        err.status = 400;
+        // @ts-expect-error
+        err.body = {
+            error: {
+                message: 'Missing or invalid parameters: objects (array) is required and must not be empty.',
+                code: 'INVALID_PARAMS',
+            },
+        };
+        throw err;
+    }
+    logger?.info(`Describing ${objects.length} objects via search`);
+    const results = [];
+    try {
+        for (const obj of objects) {
+            const type = obj.type;
+            let res = await (0, handleSearchObject_1.handleSearchObject)(context, {
+                object_name: obj.name,
+                object_type: type,
+            });
+            let parsed;
+            try {
+                parsed = typeof res === 'string' ? JSON.parse(res) : res;
+                // If the response is empty or flagged as an error, retry without explicit type
+                let tryWithoutType = false;
+                if (parsed == null ||
+                    parsed.isError === true ||
+                    (parsed.content &&
+                        Array.isArray(parsed.content) &&
+                        parsed.content.length === 0)) {
+                    tryWithoutType = true;
+                }
+                if (tryWithoutType) {
+                    res = await (0, handleSearchObject_1.handleSearchObject)(context, { object_name: obj.name });
+                    parsed = typeof res === 'string' ? JSON.parse(res) : res;
+                    // If it still fails or comes back empty, skip this object
+                    if (parsed == null ||
+                        parsed.isError === true ||
+                        (parsed.content &&
+                            Array.isArray(parsed.content) &&
+                            parsed.content.length === 0)) {
+                        continue;
+                    }
+                }
+                // When content is a non-empty array
+                if (parsed.content && Array.isArray(parsed.content)) {
+                    const contentArr = parsed.content;
+                    if (contentArr.length === 0) {
+                        continue;
+                    }
+                    // Handle SearchObject-style payloads containing a results array
+                    let allResults = [];
+                    for (const item of contentArr) {
+                        try {
+                            const parsedItem = typeof item.text === 'string'
+                                ? JSON.parse(item.text)
+                                : item.text;
+                            if (parsedItem?.results && Array.isArray(parsedItem.results)) {
+                                allResults = allResults.concat(parsedItem.results);
+                            }
+                            else {
+                                allResults.push(parsedItem);
+                            }
+                        }
+                        catch {
+                            allResults.push(item);
+                        }
+                    }
+                    results.push({
+                        type: 'text',
+                        text: JSON.stringify({
+                            name: obj.name,
+                            results: allResults,
+                        }),
+                    });
+                    continue;
+                }
+                // Otherwise handle direct object payloads (e.g., DTEL)
+                if (typeof parsed === 'object' && parsed !== null) {
+                    results.push({ type: 'text', text: JSON.stringify(parsed) });
+                }
+            }
+            catch { }
+        }
+        // Return isError: false even when nothing matched
+        return {
+            isError: false,
+            content: results,
+        };
+    }
+    catch (e) {
+        logger?.error('Failed to describe objects list', e);
+        return { isError: true, content: [] };
+    }
+}
+//# sourceMappingURL=handleDescribeByList.js.map

package/dist/src/handlers/system/readonly/handleDescribeByList.js.map

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

package/dist/src/handlers/system/readonly/handleGetAbapAST.d.ts

@@ -0,0 +1,28 @@
+import type { HandlerContext } from '../../../lib/handlers/interfaces';
+export declare const TOOL_DEFINITION: {
+    readonly name: "GetAbapAST";
+    readonly available_in: readonly ["onprem", "cloud"];
+    readonly description: "[read-only] Parse ABAP code and return AST (Abstract Syntax Tree) in JSON format.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly code: {
+                readonly type: "string";
+                readonly description: "ABAP source code to parse";
+            };
+            readonly filePath: {
+                readonly type: "string";
+                readonly description: "Optional file path to write the result to";
+            };
+        };
+        readonly required: readonly ["code"];
+    };
+};
+export declare function handleGetAbapAST(context: HandlerContext, args: any): Promise<{
+    isError: boolean;
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=handleGetAbapAST.d.ts.map

package/dist/src/handlers/system/readonly/handleGetAbapAST.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleGetAbapAST.d.ts","sourceRoot":"","sources":["../../../../../src/handlers/system/readonly/handleGetAbapAST.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAGvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AA2IX,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG;;;;;;GAuCxE"}