@mcp-abap-adt/core 4.8.9 → 5.0.0

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: 52
+- Total tools: 54
 
 ## Navigation
 
@@ -64,13 +64,15 @@ Generated from code in `src/handlers/**` (not from docs).
     - [GetTransaction](#gettransaction-read-only-system)
     - [GetTypeInfo](#gettypeinfo-read-only-system)
     - [GetWhereUsed](#getwhereused-read-only-system)
-    - [RuntimeAnalyzeDump](#runtimeanalyzedump-read-only-system)
     - [RuntimeAnalyzeProfilerTrace](#runtimeanalyzeprofilertrace-read-only-system)
     - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
     - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
+    - [RuntimeGetGatewayErrorLog](#runtimegetgatewayerrorlog-read-only-system)
     - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
     - [RuntimeListDumps](#runtimelistdumps-read-only-system)
+    - [RuntimeListFeeds](#runtimelistfeeds-read-only-system)
     - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
+    - [RuntimeListSystemMessages](#runtimelistsystemmessages-read-only-system)
     - [RuntimeRunClassWithProfiling](#runtimerunclasswithprofiling-read-only-system)
     - [RuntimeRunProgramWithProfiling](#runtimerunprogramwithprofiling-read-only-system)
   - [Table](#read-only-table)
@@ -347,7 +349,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getobjectsbytype-read-only-search"></a>
 #### GetObjectsByType (Read-Only / Search)
-**Description:** [read-only] Retrieves all ABAP objects of a specific type under a given node.
+**Description:** [read-only] Retrieves all ABAP objects of a specific type (classes, tables, programs, interfaces, etc.) under a given parent node. Useful for listing all objects of one type within a package or composite object.
 
 **Source:** `src/handlers/search/readonly/handleGetObjectsByType.ts`
 
@@ -363,7 +365,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getobjectslist-read-only-search"></a>
 #### GetObjectsList (Read-Only / Search)
-**Description:** [read-only] Recursively retrieves all valid ABAP repository objects for a given parent (program, function group, etc.) including nested includes.
+**Description:** [read-only] Recursively retrieves all child ABAP repository objects for a given parent — programs (PROG), function groups (FUGR), classes (CLAS), packages (DEVC), and other composite objects — including nested includes and subcomponents.
 
 **Source:** `src/handlers/search/readonly/handleGetObjectsList.ts`
 
@@ -377,7 +379,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="searchobject-read-only-search"></a>
 #### SearchObject (Read-Only / Search)
-**Description:** [read-only] Search for ABAP objects by name pattern. Parameters: object_name (with or without mask), object_type (optional), maxResults (optional). If object_type is specified, results are filtered by type.
+**Description:** [read-only] Find, search, locate, or check if an ABAP repository object exists by name or wildcard pattern (e.g. 
 
 **Source:** `src/handlers/search/readonly/handleSearchObject.ts`
 
@@ -484,7 +486,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getadttypes-read-only-system"></a>
 #### GetAdtTypes (Read-Only / System)
-**Description:** [read-only] Retrieve all valid ADT object types.
+**Description:** [read-only] Retrieve all valid ADT object types (CLAS, TABL, PROG, DEVC, FUGR, INTF, DDLS, DTEL, DOMA, SRVD, SRVB, BDEF, DDLX, etc.) or validate a specific type name.
 
 **Source:** `src/handlers/system/readonly/handleGetAllTypes.ts`
 
@@ -495,7 +497,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getinactiveobjects-read-only-system"></a>
 #### GetInactiveObjects (Read-Only / System)
-**Description:** [read-only] Get a list of inactive ABAP objects (objects that have been modified but not activated).
+**Description:** [read-only] Get a list of inactive ABAP objects — modified but not yet activated, pending activation. Shows classes, tables, CDS views, and other objects awaiting activation.
 
 **Source:** `src/handlers/system/readonly/handleGetInactiveObjects.ts`
 
@@ -506,7 +508,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getobjectinfo-read-only-system"></a>
 #### GetObjectInfo (Read-Only / System)
-**Description:** [read-only] Return ABAP object tree: root, group nodes, and terminal leaves up to maxDepth. Enrich each node via SearchObject if enrich=true. Group nodes are included for hierarchy. Each node has node_type: root, point, end.
+**Description:** [read-only] Return ABAP object tree structure for packages (DEVC), classes (CLAS), programs (PROG), function groups (FUGR), and other objects. Shows root, group nodes, and terminal leaves up to maxDepth. Enrich each node with description and package via SearchObject if enrich=true.
 
 **Source:** `src/handlers/system/readonly/handleGetObjectInfo.ts`
 
@@ -556,7 +558,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getsqlquery-read-only-system"></a>
 #### GetSqlQuery (Read-Only / System)
-**Description:** [read-only] Execute freestyle SQL queries via SAP ADT Data Preview API.
+**Description:** [read-only] Execute ABAP SQL SELECT queries on database tables and CDS views via SAP ADT Data Preview API. Use for ad-hoc data retrieval, row counts, and filtered queries.
 
 **Source:** `src/handlers/system/readonly/handleGetSqlQuery.ts`
 
@@ -568,7 +570,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="gettransaction-read-only-system"></a>
 #### GetTransaction (Read-Only / System)
-**Description:** [read-only] Retrieve ABAP transaction details.
+**Description:** [read-only] Retrieve ABAP transaction (t-code) details — program, screen, authorization object, and transaction type (dialog, report, OO).
 
 **Source:** `src/handlers/system/readonly/handleGetTransaction.ts`
 
@@ -579,7 +581,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="gettypeinfo-read-only-system"></a>
 #### GetTypeInfo (Read-Only / System)
-**Description:** [read-only] Retrieve ABAP type information.
+**Description:** [read-only] Retrieve ABAP type information for domains (DOMA), data elements (DTEL), table types, and structures. Returns field definitions, value ranges, fixed values, and DDIC metadata.
 
 **Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
 
@@ -591,7 +593,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="getwhereused-read-only-system"></a>
 #### GetWhereUsed (Read-Only / System)
-**Description:** [read-only] Retrieve where-used references for ABAP objects via ADT usageReferences. Returns parsed list of referencing objects with their types and packages.
+**Description:** [read-only] Find where-used references (cross-references, usages, dependencies) for ABAP objects — classes, interfaces, tables, data elements, programs, function modules, etc. Returns list of all referencing objects with their types and packages.
 
 **Source:** `src/handlers/system/readonly/handleGetWhereUsed.ts`
 
@@ -602,19 +604,6 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-<a id="runtimeanalyzedump-read-only-system"></a>
-#### RuntimeAnalyzeDump (Read-Only / System)
-**Description:** [runtime] Read runtime dump by ID and return compact analysis summary with key fields.
-
-**Source:** `src/handlers/system/readonly/handleRuntimeAnalyzeDump.ts`
-
-**Parameters:**
-- `dump_id` (string, required) - Runtime dump ID.
-- `include_payload` (boolean, optional (default: true)) - Include full parsed payload in response.
-- `view` (string, optional (default: default)) - Dump view mode to analyze: default payload, summary section, or formatted long text.
-
----
-
 <a id="runtimeanalyzeprofilertrace-read-only-system"></a>
 #### RuntimeAnalyzeProfilerTrace (Read-Only / System)
 **Description:** [runtime] Read profiler trace view and return compact analysis summary (totals + top entries).
@@ -655,18 +644,34 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="runtimegetdumpbyid-read-only-system"></a>
 #### RuntimeGetDumpById (Read-Only / System)
-**Description:** [runtime] Read a specific ABAP runtime dump. Identify the dump by datetime + user (preferred, e.g. from a CALM event), or pass dump_id directly if already known.
+**Description:** [runtime] Read a specific ABAP runtime dump. Identify the dump by datetime + user (preferred, e.g. from a CALM event), or pass dump_id directly if already known. Use response_mode to control output detail level.
 
 **Source:** `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
 
 **Parameters:**
-- `datetime` (string, optional) - Dump datetime (ISO or "YYYY-MM-DD HH:MM:SS"). Combined with user, uniquely identifies the dump. Preferred over dump_id.
+- `datetime` (string, optional) - Dump datetime (ISO or 
 - `dump_id` (string, optional) - Full runtime dump ID. Use only when already known; prefer datetime + user otherwise.
+- `response_mode` (string, optional (default: both)) - Controls what is returned: 
 - `user` (string, optional) - SAP username whose dump to read. Required when using datetime lookup.
 - `view` (string, optional (default: default)) - Dump view mode: default payload, summary section, or formatted long text.
 
 ---
 
+<a id="runtimegetgatewayerrorlog-read-only-system"></a>
+#### RuntimeGetGatewayErrorLog (Read-Only / System)
+**Description:** [runtime] List SAP Gateway error log (/IWFND/ERROR_LOG) or get error detail. Returns structured entries with type, shortText, transactionId, dateTime, username. With error_url returns full detail including serviceInfo, errorContext, sourceCode, callStack.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeGetGatewayErrorLog.ts`
+
+**Parameters:**
+- `error_url` (string, optional) - Feed URL of a specific error entry (from a previous list response link field). When provided, returns detailed error info instead of listing.
+- `from` (string, optional) - Start of time range in YYYYMMDDHHMMSS format.
+- `max_results` (number, optional) - Maximum number of errors to return.
+- `to` (string, optional) - End of time range in YYYYMMDDHHMMSS format.
+- `user` (string, optional) - Filter errors by SAP username.
+
+---
+
 <a id="runtimegetprofilertracedata-read-only-system"></a>
 #### RuntimeGetProfilerTraceData (Read-Only / System)
 **Description:** [runtime] Read profiler trace data by trace id/uri: hitlist, statements, or db accesses. Returns parsed JSON payload.
@@ -700,6 +705,21 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimelistfeeds-read-only-system"></a>
+#### RuntimeListFeeds (Read-Only / System)
+**Description:** [runtime] List available ADT runtime feeds or read a specific feed type. Feed types: dumps, system_messages, gateway_errors. Without feed_type returns available feed descriptors.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListFeeds.ts`
+
+**Parameters:**
+- `feed_type` (string, optional (default: descriptors)) - Feed to read. 
+- `from` (string, optional) - Start of time range in YYYYMMDDHHMMSS format.
+- `max_results` (number, optional) - Maximum number of entries to return.
+- `to` (string, optional) - End of time range in YYYYMMDDHHMMSS format.
+- `user` (string, optional) - Filter feed entries by SAP username.
+
+---
+
 <a id="runtimelistprofilertracefiles-read-only-system"></a>
 #### RuntimeListProfilerTraceFiles (Read-Only / System)
 **Description:** [runtime] List ABAP profiler trace files available in ADT runtime. Returns parsed JSON payload.
@@ -711,6 +731,20 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimelistsystemmessages-read-only-system"></a>
+#### RuntimeListSystemMessages (Read-Only / System)
+**Description:** [runtime] List SM02 system messages. Returns structured entries with id, title, text, severity, validity period, and author.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListSystemMessages.ts`
+
+**Parameters:**
+- `from` (string, optional) - Start of time range in YYYYMMDDHHMMSS format.
+- `max_results` (number, optional) - Maximum number of messages to return.
+- `to` (string, optional) - End of time range in YYYYMMDDHHMMSS format.
+- `user` (string, optional) - Filter by author username.
+
+---
+
 <a id="runtimerunclasswithprofiling-read-only-system"></a>
 #### RuntimeRunClassWithProfiling (Read-Only / System)
 **Description:** [runtime] Execute ABAP class with profiler enabled and return created profilerId + traceId.
@@ -766,7 +800,7 @@ Generated from code in `src/handlers/**` (not from docs).
 
 <a id="gettablecontents-read-only-table"></a>
 #### GetTableContents (Read-Only / Table)
-**Description:** [read-only] Retrieve contents of an ABAP table.
+**Description:** [read-only] Retrieve contents (data preview) of an ABAP database table or CDS view. Returns rows of data like SE16/SE16N.
 
 **Source:** `src/handlers/table/readonly/handleGetTableContents.ts`
 
@@ -830,4 +864,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-03-14*
+*Last updated: 2026-04-11*

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-abap-adt/core",
   "mcpName": "io.github.fr0ster/mcp-abap-adt",
-  "version": "4.8.9",
+  "version": "5.0.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -136,7 +136,7 @@
     "yaml": "^2.8.1"
   },
   "dependencies": {
-    "@mcp-abap-adt/adt-clients": "^3.14.5",
+    "@mcp-abap-adt/adt-clients": "^4.0.0",
     "@mcp-abap-adt/auth-broker": "^1.0.5",
     "@mcp-abap-adt/auth-providers": "^1.0.5",
     "@mcp-abap-adt/auth-stores": "^1.0.4",