@mcp-abap-adt/core 2.3.1 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/README.md +2 -1
  3. package/dist/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.d.ts +79 -0
  4. package/dist/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.d.ts.map +1 -0
  5. package/dist/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.js +75 -0
  6. package/dist/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.js.map +1 -0
  7. package/dist/handlers/system/readonly/handleRuntimeGetDumpById.d.ts +27 -0
  8. package/dist/handlers/system/readonly/handleRuntimeGetDumpById.d.ts.map +1 -0
  9. package/dist/handlers/system/readonly/handleRuntimeGetDumpById.js +48 -0
  10. package/dist/handlers/system/readonly/handleRuntimeGetDumpById.js.map +1 -0
  11. package/dist/handlers/system/readonly/handleRuntimeGetDumpByUri.d.ts +27 -0
  12. package/dist/handlers/system/readonly/handleRuntimeGetDumpByUri.d.ts.map +1 -0
  13. package/dist/handlers/system/readonly/handleRuntimeGetDumpByUri.js +47 -0
  14. package/dist/handlers/system/readonly/handleRuntimeGetDumpByUri.js.map +1 -0
  15. package/dist/handlers/system/readonly/handleRuntimeGetProfilerTraceData.d.ts +53 -0
  16. package/dist/handlers/system/readonly/handleRuntimeGetProfilerTraceData.d.ts.map +1 -0
  17. package/dist/handlers/system/readonly/handleRuntimeGetProfilerTraceData.js +83 -0
  18. package/dist/handlers/system/readonly/handleRuntimeGetProfilerTraceData.js.map +1 -0
  19. package/dist/handlers/system/readonly/handleRuntimeListDumps.d.ts +48 -0
  20. package/dist/handlers/system/readonly/handleRuntimeListDumps.d.ts.map +1 -0
  21. package/dist/handlers/system/readonly/handleRuntimeListDumps.js +75 -0
  22. package/dist/handlers/system/readonly/handleRuntimeListDumps.js.map +1 -0
  23. package/dist/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.d.ts +18 -0
  24. package/dist/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.d.ts.map +1 -0
  25. package/dist/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.js +39 -0
  26. package/dist/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.js.map +1 -0
  27. package/dist/handlers/system/readonly/runtimePayloadParser.d.ts +6 -0
  28. package/dist/handlers/system/readonly/runtimePayloadParser.d.ts.map +1 -0
  29. package/dist/handlers/system/readonly/runtimePayloadParser.js +28 -0
  30. package/dist/handlers/system/readonly/runtimePayloadParser.js.map +1 -0
  31. package/dist/lib/handlers/groups/SystemHandlersGroup.d.ts.map +1 -1
  32. package/dist/lib/handlers/groups/SystemHandlersGroup.js +45 -0
  33. package/dist/lib/handlers/groups/SystemHandlersGroup.js.map +1 -1
  34. package/dist/server/SseServer.d.ts +1 -0
  35. package/dist/server/SseServer.d.ts.map +1 -1
  36. package/dist/server/SseServer.js +6 -4
  37. package/dist/server/SseServer.js.map +1 -1
  38. package/dist/server/StreamableHttpServer.d.ts +1 -0
  39. package/dist/server/StreamableHttpServer.d.ts.map +1 -1
  40. package/dist/server/StreamableHttpServer.js +6 -4
  41. package/dist/server/StreamableHttpServer.js.map +1 -1
  42. package/dist/server/launcher.js +5 -0
  43. package/dist/server/launcher.js.map +1 -1
  44. package/docs/architecture/ARCHITECTURE.md +706 -0
  45. package/docs/architecture/README.md +1 -0
  46. package/docs/user-guide/AVAILABLE_TOOLS.md +73 -3
  47. package/docs/user-guide/AVAILABLE_TOOLS_HIGH.md +1 -1
  48. package/docs/user-guide/AVAILABLE_TOOLS_LOW.md +1 -1
  49. package/docs/user-guide/AVAILABLE_TOOLS_READONLY.md +72 -2
  50. package/package.json +7 -7
@@ -38,6 +38,7 @@ Handlers are organized into logical groups for flexible composition:
38
38
 
39
39
  ## Files
40
40
 
41
+ - **[ARCHITECTURE.md](ARCHITECTURE.md)** - Comprehensive architecture overview: server boot flow, transport/auth model, handler sets, runtime diagnostics tools, and extension points
41
42
  - **[STATEFUL_SESSION_GUIDE.md](STATEFUL_SESSION_GUIDE.md)** - Stateful ADT request flow for lock/update/unlock operations
42
43
  - **[TOOLS_ARCHITECTURE.md](TOOLS_ARCHITECTURE.md)** - MCP tools architecture and handler structure, explaining how tools are organized and how `TOOL_DEFINITION` works
43
44
  - **[CONNECTION_ISOLATION.md](CONNECTION_ISOLATION.md)** - Connection isolation architecture, explaining how per-session connection isolation prevents data mixing between clients (version 1.1.10+)
@@ -4,8 +4,8 @@ Generated from code in `src/handlers/**` (not from docs).
4
4
 
5
5
  ## Summary
6
6
 
7
- - Total tools: 238
8
- - Read-only tools: 27
7
+ - Total tools: 243
8
+ - Read-only tools: 32
9
9
  - High-level tools: 89
10
10
  - Low-level tools: 122
11
11
 
@@ -44,6 +44,11 @@ Generated from code in `src/handlers/**` (not from docs).
44
44
  - [GetTransaction](#gettransaction-read-only-system)
45
45
  - [GetTypeInfo](#gettypeinfo-read-only-system)
46
46
  - [GetWhereUsed](#getwhereused-read-only-system)
47
+ - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
48
+ - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
49
+ - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
50
+ - [RuntimeListDumps](#runtimelistdumps-read-only-system)
51
+ - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
47
52
  - [Table](#read-only-table)
48
53
  - [GetTableContents](#gettablecontents-read-only-table)
49
54
  - [Transport](#read-only-transport)
@@ -608,6 +613,7 @@ Generated from code in `src/handlers/**` (not from docs).
608
613
  **Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
609
614
 
610
615
  **Parameters:**
616
+ - `include_structure_fallback` (boolean, optional (default: true)) - When true (default), tries DDIC structure lookup only if type lookup returns 404/empty.
611
617
  - `type_name` (string, required) - Name of the ABAP type
612
618
 
613
619
  ---
@@ -625,6 +631,70 @@ Generated from code in `src/handlers/**` (not from docs).
625
631
 
626
632
  ---
627
633
 
634
+ <a id="runtimecreateprofilertraceparameters-read-only-system"></a>
635
+ #### RuntimeCreateProfilerTraceParameters (Read-Only / System)
636
+ **Description:** [runtime] Create ABAP profiler trace parameters and return profilerId (URI) for profiled execution.
637
+
638
+ **Source:** `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
639
+
640
+ **Parameters:**
641
+ - `description` (string, required) - Human-readable trace description.
642
+
643
+ ---
644
+
645
+ <a id="runtimegetdumpbyid-read-only-system"></a>
646
+ #### RuntimeGetDumpById (Read-Only / System)
647
+ **Description:** [runtime] Read a specific ABAP runtime dump by dump ID. Returns parsed JSON payload.
648
+
649
+ **Source:** `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
650
+
651
+ **Parameters:**
652
+ - `dump_id` (string, required) - Runtime dump ID (for example: 694AB694097211F1929806D06D234D38).
653
+
654
+ ---
655
+
656
+ <a id="runtimegetprofilertracedata-read-only-system"></a>
657
+ #### RuntimeGetProfilerTraceData (Read-Only / System)
658
+ **Description:** [runtime] Read profiler trace data by trace id/uri: hitlist, statements, or db accesses. Returns parsed JSON payload.
659
+
660
+ **Source:** `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts`
661
+
662
+ **Parameters:**
663
+ - `auto_drill_down_threshold` (number, optional) - Auto drill-down threshold (for statements view).
664
+ - `id` (number, optional) - Statement node ID (for statements view).
665
+ - `trace_id_or_uri` (string, required) - Profiler trace ID or full ADT trace URI.
666
+ - `view` (string, required) - Trace view to retrieve.
667
+ - `with_details` (boolean, optional) - Include statement details (for statements view).
668
+ - `with_system_events` (boolean, optional) - Include system events.
669
+
670
+ ---
671
+
672
+ <a id="runtimelistdumps-read-only-system"></a>
673
+ #### RuntimeListDumps (Read-Only / System)
674
+ **Description:** [runtime] List ABAP runtime dumps with optional user filter and paging. Returns parsed JSON payload.
675
+
676
+ **Source:** `src/handlers/system/readonly/handleRuntimeListDumps.ts`
677
+
678
+ **Parameters:**
679
+ - `inlinecount` (string, optional) - Include total count metadata.
680
+ - `orderby` (string, optional) - ADT order by expression.
681
+ - `skip` (number, optional) - Number of records to skip.
682
+ - `top` (number, optional) - Maximum number of records to return.
683
+ - `user` (string, optional) - Optional username filter. If omitted, dumps for all users are returned.
684
+
685
+ ---
686
+
687
+ <a id="runtimelistprofilertracefiles-read-only-system"></a>
688
+ #### RuntimeListProfilerTraceFiles (Read-Only / System)
689
+ **Description:** [runtime] List ABAP profiler trace files available in ADT runtime. Returns parsed JSON payload.
690
+
691
+ **Source:** `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts`
692
+
693
+ **Parameters:**
694
+ - None
695
+
696
+ ---
697
+
628
698
  <a id="read-only-table"></a>
629
699
  ### Read-Only / Table
630
700
 
@@ -3742,4 +3812,4 @@ Generated from code in `src/handlers/**` (not from docs).
3742
3812
 
3743
3813
  ---
3744
3814
 
3745
- *Last updated: 2026-02-12*
3815
+ *Last updated: 2026-02-15*
@@ -1414,4 +1414,4 @@ Generated from code in `src/handlers/**` (not from docs).
1414
1414
 
1415
1415
  ---
1416
1416
 
1417
- *Last updated: 2026-02-12*
1417
+ *Last updated: 2026-02-15*
@@ -1942,4 +1942,4 @@ Generated from code in `src/handlers/**` (not from docs).
1942
1942
 
1943
1943
  ---
1944
1944
 
1945
- *Last updated: 2026-02-12*
1945
+ *Last updated: 2026-02-15*
@@ -3,7 +3,7 @@
3
3
  Generated from code in `src/handlers/**` (not from docs).
4
4
 
5
5
  - Level: Read-Only
6
- - Total tools: 27
6
+ - Total tools: 32
7
7
 
8
8
  ## Navigation
9
9
 
@@ -40,6 +40,11 @@ Generated from code in `src/handlers/**` (not from docs).
40
40
  - [GetTransaction](#gettransaction-read-only-system)
41
41
  - [GetTypeInfo](#gettypeinfo-read-only-system)
42
42
  - [GetWhereUsed](#getwhereused-read-only-system)
43
+ - [RuntimeCreateProfilerTraceParameters](#runtimecreateprofilertraceparameters-read-only-system)
44
+ - [RuntimeGetDumpById](#runtimegetdumpbyid-read-only-system)
45
+ - [RuntimeGetProfilerTraceData](#runtimegetprofilertracedata-read-only-system)
46
+ - [RuntimeListDumps](#runtimelistdumps-read-only-system)
47
+ - [RuntimeListProfilerTraceFiles](#runtimelistprofilertracefiles-read-only-system)
43
48
  - [Table](#read-only-table)
44
49
  - [GetTableContents](#gettablecontents-read-only-table)
45
50
  - [Transport](#read-only-transport)
@@ -355,6 +360,7 @@ Generated from code in `src/handlers/**` (not from docs).
355
360
  **Source:** `src/handlers/system/readonly/handleGetTypeInfo.ts`
356
361
 
357
362
  **Parameters:**
363
+ - `include_structure_fallback` (boolean, optional (default: true)) - When true (default), tries DDIC structure lookup only if type lookup returns 404/empty.
358
364
  - `type_name` (string, required) - Name of the ABAP type
359
365
 
360
366
  ---
@@ -372,6 +378,70 @@ Generated from code in `src/handlers/**` (not from docs).
372
378
 
373
379
  ---
374
380
 
381
+ <a id="runtimecreateprofilertraceparameters-read-only-system"></a>
382
+ #### RuntimeCreateProfilerTraceParameters (Read-Only / System)
383
+ **Description:** [runtime] Create ABAP profiler trace parameters and return profilerId (URI) for profiled execution.
384
+
385
+ **Source:** `src/handlers/system/readonly/handleRuntimeCreateProfilerTraceParameters.ts`
386
+
387
+ **Parameters:**
388
+ - `description` (string, required) - Human-readable trace description.
389
+
390
+ ---
391
+
392
+ <a id="runtimegetdumpbyid-read-only-system"></a>
393
+ #### RuntimeGetDumpById (Read-Only / System)
394
+ **Description:** [runtime] Read a specific ABAP runtime dump by dump ID. Returns parsed JSON payload.
395
+
396
+ **Source:** `src/handlers/system/readonly/handleRuntimeGetDumpById.ts`
397
+
398
+ **Parameters:**
399
+ - `dump_id` (string, required) - Runtime dump ID (for example: 694AB694097211F1929806D06D234D38).
400
+
401
+ ---
402
+
403
+ <a id="runtimegetprofilertracedata-read-only-system"></a>
404
+ #### RuntimeGetProfilerTraceData (Read-Only / System)
405
+ **Description:** [runtime] Read profiler trace data by trace id/uri: hitlist, statements, or db accesses. Returns parsed JSON payload.
406
+
407
+ **Source:** `src/handlers/system/readonly/handleRuntimeGetProfilerTraceData.ts`
408
+
409
+ **Parameters:**
410
+ - `auto_drill_down_threshold` (number, optional) - Auto drill-down threshold (for statements view).
411
+ - `id` (number, optional) - Statement node ID (for statements view).
412
+ - `trace_id_or_uri` (string, required) - Profiler trace ID or full ADT trace URI.
413
+ - `view` (string, required) - Trace view to retrieve.
414
+ - `with_details` (boolean, optional) - Include statement details (for statements view).
415
+ - `with_system_events` (boolean, optional) - Include system events.
416
+
417
+ ---
418
+
419
+ <a id="runtimelistdumps-read-only-system"></a>
420
+ #### RuntimeListDumps (Read-Only / System)
421
+ **Description:** [runtime] List ABAP runtime dumps with optional user filter and paging. Returns parsed JSON payload.
422
+
423
+ **Source:** `src/handlers/system/readonly/handleRuntimeListDumps.ts`
424
+
425
+ **Parameters:**
426
+ - `inlinecount` (string, optional) - Include total count metadata.
427
+ - `orderby` (string, optional) - ADT order by expression.
428
+ - `skip` (number, optional) - Number of records to skip.
429
+ - `top` (number, optional) - Maximum number of records to return.
430
+ - `user` (string, optional) - Optional username filter. If omitted, dumps for all users are returned.
431
+
432
+ ---
433
+
434
+ <a id="runtimelistprofilertracefiles-read-only-system"></a>
435
+ #### RuntimeListProfilerTraceFiles (Read-Only / System)
436
+ **Description:** [runtime] List ABAP profiler trace files available in ADT runtime. Returns parsed JSON payload.
437
+
438
+ **Source:** `src/handlers/system/readonly/handleRuntimeListProfilerTraceFiles.ts`
439
+
440
+ **Parameters:**
441
+ - None
442
+
443
+ ---
444
+
375
445
  <a id="read-only-table"></a>
376
446
  ### Read-Only / Table
377
447
 
@@ -402,4 +472,4 @@ Generated from code in `src/handlers/**` (not from docs).
402
472
 
403
473
  ---
404
474
 
405
- *Last updated: 2026-02-12*
475
+ *Last updated: 2026-02-15*
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mcp-abap-adt/core",
3
3
  "mcpName": "io.github.fr0ster/mcp-abap-adt",
4
- "version": "2.3.1",
4
+ "version": "2.4.1",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
7
7
  "exports": {
@@ -125,13 +125,13 @@
125
125
  "yaml": "^2.8.1"
126
126
  },
127
127
  "dependencies": {
128
- "@mcp-abap-adt/adt-clients": "^0.3.13",
129
- "@mcp-abap-adt/auth-broker": "^0.3.6",
130
- "@mcp-abap-adt/auth-providers": "^0.2.10",
131
- "@mcp-abap-adt/auth-stores": "^0.3.0",
132
- "@mcp-abap-adt/connection": "^0.2.9",
128
+ "@mcp-abap-adt/adt-clients": "^0.3.16",
129
+ "@mcp-abap-adt/auth-broker": "^1.0.5",
130
+ "@mcp-abap-adt/auth-providers": "^1.0.5",
131
+ "@mcp-abap-adt/auth-stores": "^1.0.2",
132
+ "@mcp-abap-adt/connection": "^1.1.0",
133
133
  "@mcp-abap-adt/header-validator": "^0.1.8",
134
- "@mcp-abap-adt/interfaces": "^0.2.15",
134
+ "@mcp-abap-adt/interfaces": "^2.5.0",
135
135
  "@mcp-abap-adt/logger": "^0.1.4",
136
136
  "@modelcontextprotocol/sdk": "^1.26.0",
137
137
  "axios": "^1.13.5",