@mcp-abap-adt/core 2.3.0 → 2.4.0

package/docs/architecture/README.md

@@ -38,6 +38,7 @@ Handlers are organized into logical groups for flexible composition:
 
 ## Files
 
+- **[ARCHITECTURE.md](ARCHITECTURE.md)** - Comprehensive architecture overview: server boot flow, transport/auth model, handler sets, runtime diagnostics tools, and extension points
 - **[STATEFUL_SESSION_GUIDE.md](STATEFUL_SESSION_GUIDE.md)** - Stateful ADT request flow for lock/update/unlock operations
 - **[TOOLS_ARCHITECTURE.md](TOOLS_ARCHITECTURE.md)** - MCP tools architecture and handler structure, explaining how tools are organized and how `TOOL_DEFINITION` works
 - **[CONNECTION_ISOLATION.md](CONNECTION_ISOLATION.md)** - Connection isolation architecture, explaining how per-session connection isolation prevents data mixing between clients (version 1.1.10+)

package/docs/configuration/YAML_CONFIG.md

@@ -6,7 +6,7 @@ The MCP ABAP ADT server supports YAML configuration files to simplify server set
 
 1. **Generate a template:**
    ```bash
-   mcp-abap-adt --config=config.yaml
+   mcp-abap-adt --conf=config.yaml
    ```
    If the file doesn't exist, a template will be automatically generated.
 
@@ -15,7 +15,7 @@ The MCP ABAP ADT server supports YAML configuration files to simplify server set
 
 3. **Run with config:**
    ```bash
-   mcp-abap-adt --config=config.yaml
+   mcp-abap-adt --conf=config.yaml
    ```
 
 ## Command-Line Override
@@ -28,7 +28,7 @@ Command-line arguments **always override** YAML values. This allows you to:
 Example:
 ```bash
 # Use config.yaml but override the port
-mcp-abap-adt --config=config.yaml --http-port=8080
+mcp-abap-adt --conf=config.yaml --http-port=8080
 ```
 
 ## Configuration File Structure
@@ -41,8 +41,11 @@ transport: stdio
 # Default MCP destination (uses auth-broker)
 mcp: TRIAL
 
-# Path to .env file (alternative to mcp destination)
-env: .env
+# Env destination name in sessions store (e.g. trial -> trial.env)
+env: trial
+
+# Explicit path to .env file (recommended for file-based config)
+env-path: .env
 
 # Use unsafe mode (file-based session store)
 unsafe: false
@@ -83,7 +86,8 @@ sse:
 |--------|------|---------|-------------|
 | `transport` | string | `stdio` | Transport type: `stdio` (default, for MCP clients), `http`, `streamable-http`, or `sse` |
 | `mcp` | string | - | Default MCP destination name (uses auth-broker) |
-| `env` | string | - | Path to `.env` file (alternative to `mcp` destination) |
+| `env` | string | - | Destination name resolved from sessions store (`sessions/<name>.env`) |
+| `env-path` | string | - | Explicit path to `.env` file |
 | `unsafe` | boolean | `false` | Use file-based session store (persists to disk) |
 | `auth-broker` | boolean | `false` | Force use of auth-broker (service keys) instead of `.env` |
 | `auth-broker-path` | string | - | Custom path for auth-broker storage |
@@ -120,7 +124,7 @@ mcp: TRIAL
 
 Usage:
 ```bash
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 ```
 
 ### Example 2: HTTP Mode with Custom Port
@@ -134,7 +138,7 @@ http:
 
 Usage:
 ```bash
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 ```
 
 ### Example 3: SSE Mode with CORS
@@ -150,19 +154,19 @@ sse:
 
 Usage:
 ```bash
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 ```
 
 ### Example 4: stdio Mode with .env File
 
 ```yaml
 transport: stdio
-env: .env
+env-path: .env
 ```
 
 Usage:
 ```bash
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 ```
 
 ### Example 5: HTTP Mode with Auth-Broker
@@ -178,7 +182,7 @@ http:
 
 Usage:
 ```bash
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 ```
 
 ## Testing Scenarios
@@ -194,7 +198,7 @@ mcp: TRIAL
 ### Test Config 2: stdio-env.yaml
 ```yaml
 transport: stdio
-env: .env
+env-path: .env
 ```
 
 ### Test Config 3: http-default.yaml
@@ -215,10 +219,10 @@ sse:
 
 Run tests with different configs:
 ```bash
-mcp-abap-adt --config=stdio-stdio.yaml
-mcp-abap-adt --config=stdio-env.yaml
-mcp-abap-adt --config=http-default.yaml
-mcp-abap-adt --config=sse-cors.yaml
+mcp-abap-adt --conf=stdio-stdio.yaml
+mcp-abap-adt --conf=stdio-env.yaml
+mcp-abap-adt --conf=http-default.yaml
+mcp-abap-adt --conf=sse-cors.yaml
 ```
 
 ## Benefits
@@ -231,7 +235,7 @@ mcp-abap-adt --config=sse-cors.yaml
 
 ## Template Generation
 
-When you specify `--config=<path>` and the file doesn't exist, a template is automatically generated with:
+When you specify `--conf=<path>` (or `--config=<path>`) and the file doesn't exist, a template is automatically generated with:
 - All available options
 - Default values
 - Comments explaining each option
@@ -248,13 +252,13 @@ Edit the template to customize your configuration.
 Examples:
 ```bash
 # Relative path (resolved from current directory)
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 
 # Absolute path
-mcp-abap-adt --config=/path/to/config.yaml
+mcp-abap-adt --conf=/path/to/config.yaml
 
 # Home directory
-mcp-abap-adt --config=~/config.yaml
+mcp-abap-adt --conf=~/config.yaml
 ```
 
 ## Error Handling
@@ -269,4 +273,3 @@ If the YAML file has syntax errors or invalid values:
 - [CLI Options](user-guide/CLI_OPTIONS.md) - Complete list of command-line options
 - [Client Configuration](user-guide/CLIENT_CONFIGURATION.md) - How to configure MCP clients
 - [Installation Guide](installation/INSTALLATION.md) - Server installation instructions
-

package/docs/user-guide/AVAILABLE_TOOLS.md

@@ -4,8 +4,8 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ## Summary
 
-- Total tools: 238
-- Read-only tools: 27
+- Total tools: 243
+- Read-only tools: 32
 - High-level tools: 89
 - Low-level tools: 122
 
@@ -44,6 +44,11 @@ Generated from code in `src/handlers/**` (not from docs).
     - [GetTransaction](#gettransaction-read-only-system)
     - [GetTypeInfo](#gettypeinfo-read-only-system)
     - [GetWhereUsed](#getwhereused-read-only-system)
+    - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
+    - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
+    - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
+    - [RuntimeListDumps](#runtimelistdumps-read-only-system)
+    - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
   - [Table](#read-only-table)
     - [GetTableContents](#gettablecontents-read-only-table)
   - [Transport](#read-only-transport)
@@ -608,6 +613,7 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
 
 **Parameters:**
+- `include_structure_fallback` (boolean, optional (default: true)) - When true (default), tries DDIC structure lookup only if type lookup returns 404/empty.
 - `type_name` (string, required) - Name of the ABAP type
 
 ---
@@ -625,6 +631,70 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimecreateprofilertraceparameters-read-only-system"></a>
+#### RuntimeCreateProfilerTraceParameters (Read-Only / System)
+**Description:** [runtime] Create ABAP profiler trace parameters and return profilerId (URI) for profiled execution.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
+
+**Parameters:**
+- `description` (string, required) - Human-readable trace description.
+
+---
+
+<a id="runtimegetdumpbyid-read-only-system"></a>
+#### RuntimeGetDumpById (Read-Only / System)
+**Description:** [runtime] Read a specific ABAP runtime dump by dump ID. Returns parsed JSON payload.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
+
+**Parameters:**
+- `dump_id` (string, required) - Runtime dump ID (for example: 694AB694097211F1929806D06D234D38).
+
+---
+
+<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.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts`
+
+**Parameters:**
+- `auto_drill_down_threshold` (number, optional) - Auto drill-down threshold (for statements view).
+- `id` (number, optional) - Statement node ID (for statements view).
+- `trace_id_or_uri` (string, required) - Profiler trace ID or full ADT trace URI.
+- `view` (string, required) - Trace view to retrieve.
+- `with_details` (boolean, optional) - Include statement details (for statements view).
+- `with_system_events` (boolean, optional) - Include system events.
+
+---
+
+<a id="runtimelistdumps-read-only-system"></a>
+#### RuntimeListDumps (Read-Only / System)
+**Description:** [runtime] List ABAP runtime dumps with optional user filter and paging. Returns parsed JSON payload.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListDumps.ts`
+
+**Parameters:**
+- `inlinecount` (string, optional) - Include total count metadata.
+- `orderby` (string, optional) - ADT order by expression.
+- `skip` (number, optional) - Number of records to skip.
+- `top` (number, optional) - Maximum number of records to return.
+- `user` (string, optional) - Optional username filter. If omitted, dumps for all users are returned.
+
+---
+
+<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.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts`
+
+**Parameters:**
+- None
+
+---
+
 <a id="read-only-table"></a>
 ### Read-Only / Table
 
@@ -3742,4 +3812,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-12*
+*Last updated: 2026-02-15*

package/docs/user-guide/AVAILABLE_TOOLS_HIGH.md

@@ -1414,4 +1414,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-12*
+*Last updated: 2026-02-15*

package/docs/user-guide/AVAILABLE_TOOLS_LOW.md

@@ -1942,4 +1942,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-12*
+*Last updated: 2026-02-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: 27
+- Total tools: 32
 
 ## Navigation
 
@@ -40,6 +40,11 @@ Generated from code in `src/handlers/**` (not from docs).
     - [GetTransaction](#gettransaction-read-only-system)
     - [GetTypeInfo](#gettypeinfo-read-only-system)
     - [GetWhereUsed](#getwhereused-read-only-system)
+    - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
+    - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
+    - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
+    - [RuntimeListDumps](#runtimelistdumps-read-only-system)
+    - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
   - [Table](#read-only-table)
     - [GetTableContents](#gettablecontents-read-only-table)
   - [Transport](#read-only-transport)
@@ -355,6 +360,7 @@ Generated from code in `src/handlers/**` (not from docs).
 **Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
 
 **Parameters:**
+- `include_structure_fallback` (boolean, optional (default: true)) - When true (default), tries DDIC structure lookup only if type lookup returns 404/empty.
 - `type_name` (string, required) - Name of the ABAP type
 
 ---
@@ -372,6 +378,70 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
+<a id="runtimecreateprofilertraceparameters-read-only-system"></a>
+#### RuntimeCreateProfilerTraceParameters (Read-Only / System)
+**Description:** [runtime] Create ABAP profiler trace parameters and return profilerId (URI) for profiled execution.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
+
+**Parameters:**
+- `description` (string, required) - Human-readable trace description.
+
+---
+
+<a id="runtimegetdumpbyid-read-only-system"></a>
+#### RuntimeGetDumpById (Read-Only / System)
+**Description:** [runtime] Read a specific ABAP runtime dump by dump ID. Returns parsed JSON payload.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
+
+**Parameters:**
+- `dump_id` (string, required) - Runtime dump ID (for example: 694AB694097211F1929806D06D234D38).
+
+---
+
+<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.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts`
+
+**Parameters:**
+- `auto_drill_down_threshold` (number, optional) - Auto drill-down threshold (for statements view).
+- `id` (number, optional) - Statement node ID (for statements view).
+- `trace_id_or_uri` (string, required) - Profiler trace ID or full ADT trace URI.
+- `view` (string, required) - Trace view to retrieve.
+- `with_details` (boolean, optional) - Include statement details (for statements view).
+- `with_system_events` (boolean, optional) - Include system events.
+
+---
+
+<a id="runtimelistdumps-read-only-system"></a>
+#### RuntimeListDumps (Read-Only / System)
+**Description:** [runtime] List ABAP runtime dumps with optional user filter and paging. Returns parsed JSON payload.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListDumps.ts`
+
+**Parameters:**
+- `inlinecount` (string, optional) - Include total count metadata.
+- `orderby` (string, optional) - ADT order by expression.
+- `skip` (number, optional) - Number of records to skip.
+- `top` (number, optional) - Maximum number of records to return.
+- `user` (string, optional) - Optional username filter. If omitted, dumps for all users are returned.
+
+---
+
+<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.
+
+**Source:** `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts`
+
+**Parameters:**
+- None
+
+---
+
 <a id="read-only-table"></a>
 ### Read-Only / Table
 
@@ -402,4 +472,4 @@ Generated from code in `src/handlers/**` (not from docs).
 
 ---
 
-*Last updated: 2026-02-12*
+*Last updated: 2026-02-15*

package/docs/user-guide/CLI_OPTIONS.md

@@ -20,16 +20,16 @@ The help message shows all available options for all transport modes.
 
 ### YAML Configuration File
 
-**--config=\<path\>** or **--config \<path\>**
+**--conf=\<path\>** or **--conf \<path\>** (alias: `--config`)
 
 Load server configuration from a YAML file instead of command-line arguments. If the file doesn't exist, a template will be automatically generated.
 
 ```bash
 # Use YAML config file
-mcp-abap-adt --config=config.yaml
+mcp-abap-adt --conf=config.yaml
 
 # Override YAML values with command-line arguments
-mcp-abap-adt --config=config.yaml --http-port=8080
+mcp-abap-adt --conf=config.yaml --http-port=8080
 ```
 
 **Benefits:**
@@ -132,7 +132,7 @@ mcp-abap-adt --transport=sse
 
 **--mcp=\<destination\>**
 
-Default MCP destination name. When specified, this destination will be used when `x-mcp-destination` header is not provided in the request. This allows using auth-broker (service keys) with stdio and SSE transports.
+Default MCP destination name. When specified, this destination is used when `x-mcp-destination` header is not provided.
 
 ```bash
 # Use stdio with auth-broker (--mcp parameter)
@@ -141,7 +141,7 @@ mcp-abap-adt --transport=stdio --mcp=TRIAL
 # Use SSE with auth-broker (--mcp parameter)
 mcp-abap-adt --transport=sse --mcp=TRIAL
 
-# Use HTTP with default destination (overrides x-mcp-destination header if not provided)
+# Use HTTP with default destination (fallback when x-mcp-destination is not provided)
 mcp-abap-adt --transport=http --mcp=TRIAL
 ```
 
@@ -149,6 +149,7 @@ mcp-abap-adt --transport=http --mcp=TRIAL
 - For **stdio transport**: The server initializes auth-broker with the specified destination at startup
 - For **SSE transport**: The server uses the specified destination when `x-mcp-destination` header is not provided
 - For **HTTP transport**: The server uses the specified destination as a fallback when `x-mcp-destination` header is not provided
+- If neither header nor default destination is provided, HTTP/SSE requests are rejected with `400` (missing SAP connection context)
 - **`.env` file is not loaded automatically** when `--mcp` is specified (even if it exists in current directory)
 - **`.env` file is not considered mandatory** for stdio and SSE transports when `--mcp` is specified
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mcp-abap-adt/core",
   "mcpName": "io.github.fr0ster/mcp-abap-adt",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -125,13 +125,13 @@
     "yaml": "^2.8.1"
   },
   "dependencies": {
-    "@mcp-abap-adt/adt-clients": "^0.3.13",
-    "@mcp-abap-adt/auth-broker": "^0.3.6",
-    "@mcp-abap-adt/auth-providers": "^0.2.10",
-    "@mcp-abap-adt/auth-stores": "^0.3.0",
-    "@mcp-abap-adt/connection": "^0.2.9",
+    "@mcp-abap-adt/adt-clients": "^0.3.16",
+    "@mcp-abap-adt/auth-broker": "^1.0.5",
+    "@mcp-abap-adt/auth-providers": "^1.0.5",
+    "@mcp-abap-adt/auth-stores": "^1.0.2",
+    "@mcp-abap-adt/connection": "^1.1.0",
     "@mcp-abap-adt/header-validator": "^0.1.8",
-    "@mcp-abap-adt/interfaces": "^0.2.15",
+    "@mcp-abap-adt/interfaces": "^2.5.0",
     "@mcp-abap-adt/logger": "^0.1.4",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "axios": "^1.13.5",