@mcp-abap-adt/adt-clients 25.0.1 → 26.0.0

package/README.md

@@ -21,7 +21,8 @@ TypeScript clients for SAP ABAP Development Tools (ADT).
 - ✅ **Client API** – simplified interface for common operations:
   - `AdtClient` – high-level CRUD API; one member, one ADT request
   - `AdtExecutor` – execution API via `IExecutor` contracts (class/program, with profiling)
-  - `AdtRuntimeClient` – runtime operations (ABAP debugger, traces, logs, dumps, ATC check runs)
+  - `AdtRuntimeClient` – runtime operations (traces, logs, dumps, ATC check runs)
+  - `AbapDebugger`, `AmdpDebugger`, `MemorySnapshots` – the ABAP and AMDP debuggers and memory snapshots, each on connections the caller opens
   - `AdtClientsWS` – realtime WebSocket facade for event-driven workflows
   - `AdtAbapGitClient` – standalone client for SAP-official ADT-integrated abapGit (`/sap/bc/adt/abapgit/*`); available on cloud and modern on-prem (ABAP Platform 2022+)
 - ✅ **ABAP Unit test support** – run and manage ABAP Unit tests (class and CDS view tests)
@@ -134,7 +135,7 @@ npm install @mcp-abap-adt/adt-clients
    - Example: `await client.getClass().create({...})` — the POST, and nothing else
 
 2. **AdtRuntimeClient**
-   - Stable runtime operations for ABAP debugging, traces, dumps, logs, feeds, ATC check runs, and more
+   - Stable runtime operations for traces, dumps, logs, feeds, ATC check runs, and more
    - Factory accessors: `getProfiler()`, `getCrossTrace()`, `getSt05Trace()`, `getApplicationLog()`, `getAtc()`, `getAtcLog()`, `getDdicActivation()`, `getDumps()`, `getFeeds()`, `getSystemMessages()`, `getGatewayErrorLog()`
    - Each takes an optional result set (`getProfiler({ ...profilerDocuments, list: profilerTraceEntries })`) and builds a fresh implementation per call — nothing is cached, so one caller's readings never become another's
    - `getAtc()` runs ATC checks; `getAtcLog()` reads the execution and check-failure logs. Same subject, different resources — see [ATC check runs](docs/usage/CLIENT_API_REFERENCE.md#atc-check-runs)
@@ -157,8 +158,13 @@ npm install @mcp-abap-adt/adt-clients
 
 5. **AdtClientsWS**
    - Realtime request/event facade over `IWebSocketTransport`
-   - Includes debugger-session facade: listen, attach, step, stack, variables
-   - Example: `await wsClient.request('debugger.listen', { timeoutSeconds: 30 })`
+   - Example: `await wsClient.request('<operation>', { … })` against a backend that speaks its envelope
+
+6. **AbapDebugger, AmdpDebugger, MemorySnapshots**
+   - Standalone, from `@mcp-abap-adt/adt-clients/runtime` or the root: `new AbapDebugger(connection, logger, results?, { onConflict? })`
+   - One member per request, contracts `IAbapDebugger`, `IAmdpDebugger`, `IMemorySnapshots` from `@mcp-abap-adt/interfaces-adt`
+   - **Two sessions.** The ABAP listener holds one stateful connection; each debuggee caught is attached on a new one, routed to its application server. The AMDP debugger answers events on one session and takes commands on another
+   - See [Debugging](docs/usage/CLIENT_API_REFERENCE.md#debugging)
 
 ## Supported Object Types
 
@@ -317,8 +323,7 @@ const wsClient = new AdtClientsWS(transport, console, {
 
 await wsClient.connect('wss://your-realtime-endpoint');
 
-await debuggerSession.listen({ timeoutSeconds: 60 });
-await debuggerSession.step({ action: 'step_over' });
+const answer = await wsClient.request('<operation>', { /* payload */ });
 ```
 
 ### Using AdtExecutor (Execution API)
@@ -925,7 +930,8 @@ configure the client at all, so they belong with everything else a consumer impo
 the library. They now live in `@mcp-abap-adt/interfaces-adt`, alongside `IAdtContentTypes` /
 `IAdtHeaders` (the header-provider contract — `AdtContentTypesBase` and
 `AdtContentTypesModern`, the two shipped implementations, stay here), the three `IBatch*`
-shapes, the twelve abapGit types, the ten executor types, and the five debugger types. This
+shapes, the twelve abapGit types, the ten executor types, and the debugger and memory-snapshot
+contracts (`IAbapDebugger`, `IAmdpDebugger`, `IMemorySnapshots`, 13.1.0). This
 package no longer declares or exports any contract type — every contract name it uses is
 sourced from the contract packages.
 

package/dist/core/program/update.d.ts

@@ -7,5 +7,5 @@ import type { IAbapConnection } from '@mcp-abap-adt/interfaces-adt-connection';
  * This function does NOT lock/unlock - it assumes the object is already locked
  * Used internally by AdtProgram
  */
-export declare function uploadProgramSource(connection: IAbapConnection, programName: string, sourceCode: string, lockHandle: string, _sessionId: string, corrNr?: string): Promise<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<any, any>>;
+export declare function uploadProgramSource(connection: IAbapConnection, programName: string, sourceCode: string, lockHandle: string, _sessionId: string, corrNr?: string): Promise<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<unknown, unknown>>;
 //# sourceMappingURL=update.d.ts.map

package/dist/core/program/update.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/core/program/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAK/E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,yFAmBhB"}
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/core/program/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAK/E;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,eAAe,EAC3B,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,iGAmBhB"}

package/dist/core/shared/deleteLegacy.d.ts

@@ -16,5 +16,5 @@ import type { IAbapConnection } from '@mcp-abap-adt/interfaces-adt-connection';
  * @param lockHandle - Passed through when the caller holds one; optional
  * @param transportRequest - Optional transport request number
  */
-export declare function deleteObjectDirect(connection: IAbapConnection, objectUrl: string, lockHandle: string | undefined, transportRequest?: string): Promise<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<any, any>>;
+export declare function deleteObjectDirect(connection: IAbapConnection, objectUrl: string, lockHandle: string | undefined, transportRequest?: string): Promise<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<unknown, unknown>>;
 //# sourceMappingURL=deleteLegacy.d.ts.map

package/dist/core/shared/deleteLegacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deleteLegacy.d.ts","sourceRoot":"","sources":["../../../src/core/shared/deleteLegacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,gBAAgB,CAAC,EAAE,MAAM,yFAU1B"}
+{"version":3,"file":"deleteLegacy.d.ts","sourceRoot":"","sources":["../../../src/core/shared/deleteLegacy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,eAAe,EAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,gBAAgB,CAAC,EAAE,MAAM,iGAU1B"}

package/dist/index.runtime.d.ts

@@ -7,10 +7,14 @@ export { ApplicationLog, applicationLogDocuments, type IApplicationLogResults, }
 export { AdtAtc, atcDocuments, type IAtcResults, } from './runtime/atc/AdtAtc';
 export { AtcLog, atcLogDocuments, type IAtcLogResults, } from './runtime/atc/AtcLog';
 export { DdicActivation, ddicActivationDocuments, type IDdicActivationResults, } from './runtime/ddic/DdicActivation';
+export { AbapDebugger, abapDebuggerDocuments, type IAbapDebuggerOptions, type IAbapDebuggerResults, } from './runtime/debugger/AbapDebugger';
+export { AmdpDebugger, amdpDebuggerDocuments, type IAmdpDebuggerResults, } from './runtime/debugger/AmdpDebugger';
+export type { IDebuggerListenerConflict } from './runtime/debugger/abap';
 export { buildDumpIdPrefix, buildRuntimeDumpsUserQuery, } from './runtime/dumps';
 export { type IRuntimeDumpsResults, RuntimeDumps, runtimeDumpsDocuments, } from './runtime/dumps/RuntimeDumps';
 export { FeedRepository, feedDocuments, type IFeedResults, } from './runtime/feeds/FeedRepository';
 export { GatewayErrorLog, gatewayErrorLogDocuments, type IGatewayErrorLogResults, } from './runtime/gatewayErrorLog/GatewayErrorLog';
+export { type IMemorySnapshotsResults, MemorySnapshots, memorySnapshotsDocuments, } from './runtime/memory/MemorySnapshots';
 export { type ISystemMessagesResults, SystemMessages, systemMessagesDocuments, } from './runtime/systemMessages/SystemMessages';
 export { CrossTrace, crossTraceDocuments, type ICrossTraceResultSet, } from './runtime/traces/CrossTraceDomain';
 export { type IProfilerResults, Profiler, profilerDocuments, } from './runtime/traces/ProfilerDomain';

package/dist/index.runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.runtime.d.ts","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,MAAM,EACN,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,oBAAoB,EACzB,YAAY,EACZ,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,2CAA2C,CAAC;AAGnD,OAAO,EACL,KAAK,sBAAsB,EAC3B,cAAc,EACd,uBAAuB,GACxB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,KAAK,gBAAgB,EACrB,QAAQ,EACR,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,iBAAiB,EACtB,SAAS,EACT,kBAAkB,GACnB,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.runtime.d.ts","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,EACL,MAAM,EACN,YAAY,EACZ,KAAK,WAAW,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,MAAM,EACN,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,+BAA+B,CAAC;AAIvC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EACL,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,oBAAoB,EACzB,YAAY,EACZ,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,KAAK,uBAAuB,EAC5B,eAAe,EACf,wBAAwB,GACzB,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EACL,KAAK,sBAAsB,EAC3B,cAAc,EACd,uBAAuB,GACxB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,KAAK,gBAAgB,EACrB,QAAQ,EACR,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,iBAAiB,EACtB,SAAS,EACT,kBAAkB,GACnB,MAAM,4BAA4B,CAAC"}

package/dist/index.runtime.js

@@ -4,7 +4,7 @@
  * Covers: AdtRuntimeClient and all runtime/** modules.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.st05TraceDocuments = exports.St05Trace = exports.profilerDocuments = exports.Profiler = exports.crossTraceDocuments = exports.CrossTrace = exports.systemMessagesDocuments = exports.SystemMessages = exports.gatewayErrorLogDocuments = exports.GatewayErrorLog = exports.feedDocuments = exports.FeedRepository = exports.runtimeDumpsDocuments = exports.RuntimeDumps = exports.buildRuntimeDumpsUserQuery = exports.buildDumpIdPrefix = exports.ddicActivationDocuments = exports.DdicActivation = exports.atcLogDocuments = exports.AtcLog = exports.atcDocuments = exports.AdtAtc = exports.applicationLogDocuments = exports.ApplicationLog = exports.AdtRuntimeClient = void 0;
+exports.st05TraceDocuments = exports.St05Trace = exports.profilerDocuments = exports.Profiler = exports.crossTraceDocuments = exports.CrossTrace = exports.systemMessagesDocuments = exports.SystemMessages = exports.memorySnapshotsDocuments = exports.MemorySnapshots = exports.gatewayErrorLogDocuments = exports.GatewayErrorLog = exports.feedDocuments = exports.FeedRepository = exports.runtimeDumpsDocuments = exports.RuntimeDumps = exports.buildRuntimeDumpsUserQuery = exports.buildDumpIdPrefix = exports.amdpDebuggerDocuments = exports.AmdpDebugger = exports.abapDebuggerDocuments = exports.AbapDebugger = exports.ddicActivationDocuments = exports.DdicActivation = exports.atcLogDocuments = exports.AtcLog = exports.atcDocuments = exports.AdtAtc = exports.applicationLogDocuments = exports.ApplicationLog = exports.AdtRuntimeClient = void 0;
 var AdtRuntimeClient_1 = require("./clients/AdtRuntimeClient");
 Object.defineProperty(exports, "AdtRuntimeClient", { enumerable: true, get: function () { return AdtRuntimeClient_1.AdtRuntimeClient; } });
 var ApplicationLog_1 = require("./runtime/applicationLog/ApplicationLog");
@@ -19,6 +19,15 @@ Object.defineProperty(exports, "atcLogDocuments", { enumerable: true, get: funct
 var DdicActivation_1 = require("./runtime/ddic/DdicActivation");
 Object.defineProperty(exports, "DdicActivation", { enumerable: true, get: function () { return DdicActivation_1.DdicActivation; } });
 Object.defineProperty(exports, "ddicActivationDocuments", { enumerable: true, get: function () { return DdicActivation_1.ddicActivationDocuments; } });
+// The debuggers and memory snapshots. Each needs sessions of its own — see
+// their class docs — so they are constructed on connections the caller opens,
+// not handed out by AdtRuntimeClient.
+var AbapDebugger_1 = require("./runtime/debugger/AbapDebugger");
+Object.defineProperty(exports, "AbapDebugger", { enumerable: true, get: function () { return AbapDebugger_1.AbapDebugger; } });
+Object.defineProperty(exports, "abapDebuggerDocuments", { enumerable: true, get: function () { return AbapDebugger_1.abapDebuggerDocuments; } });
+var AmdpDebugger_1 = require("./runtime/debugger/AmdpDebugger");
+Object.defineProperty(exports, "AmdpDebugger", { enumerable: true, get: function () { return AmdpDebugger_1.AmdpDebugger; } });
+Object.defineProperty(exports, "amdpDebuggerDocuments", { enumerable: true, get: function () { return AmdpDebugger_1.amdpDebuggerDocuments; } });
 // Keep low-level dump types/functions (may be used by consumers)
 var dumps_1 = require("./runtime/dumps");
 Object.defineProperty(exports, "buildDumpIdPrefix", { enumerable: true, get: function () { return dumps_1.buildDumpIdPrefix; } });
@@ -32,6 +41,9 @@ Object.defineProperty(exports, "feedDocuments", { enumerable: true, get: functio
 var GatewayErrorLog_1 = require("./runtime/gatewayErrorLog/GatewayErrorLog");
 Object.defineProperty(exports, "GatewayErrorLog", { enumerable: true, get: function () { return GatewayErrorLog_1.GatewayErrorLog; } });
 Object.defineProperty(exports, "gatewayErrorLogDocuments", { enumerable: true, get: function () { return GatewayErrorLog_1.gatewayErrorLogDocuments; } });
+var MemorySnapshots_1 = require("./runtime/memory/MemorySnapshots");
+Object.defineProperty(exports, "MemorySnapshots", { enumerable: true, get: function () { return MemorySnapshots_1.MemorySnapshots; } });
+Object.defineProperty(exports, "memorySnapshotsDocuments", { enumerable: true, get: function () { return MemorySnapshots_1.memorySnapshotsDocuments; } });
 // The class is still exported for backward compatibility
 var SystemMessages_1 = require("./runtime/systemMessages/SystemMessages");
 Object.defineProperty(exports, "SystemMessages", { enumerable: true, get: function () { return SystemMessages_1.SystemMessages; } });

package/dist/runtime/debugger/AbapDebugger.d.ts

@@ -0,0 +1,93 @@
+/**
+ * AbapDebugger - Domain object for the standard ABAP debugger
+ *
+ * One member per request of the measured sequence in `./abap.ts`; the order,
+ * the stateful session and the second session that runs the program are the
+ * caller's.
+ */
+import type { IAbapDebugger, IAdtAnalyseOptions, IAdtError, IAdtResponse, IDebuggerBreakpoint, IDebuggerIdentity, IDebuggerStepMethod, IDebuggerStepToLineMethod, IResultStrategy } from '@mcp-abap-adt/interfaces-adt';
+import type { IAbapConnection } from '@mcp-abap-adt/interfaces-adt-connection';
+import type { ILogger } from '@mcp-abap-adt/interfaces-utils';
+import { type IDebuggerListenerConflict } from './abap';
+/** One strategy per kind of answer the debugger gives. */
+export interface IAbapDebuggerResults {
+    readonly breakpoints: IResultStrategy<unknown>;
+    readonly listener: IResultStrategy<unknown>;
+    readonly attach: IResultStrategy<unknown>;
+    readonly stack: IResultStrategy<unknown>;
+    readonly variables: IResultStrategy<unknown>;
+    readonly step: IResultStrategy<unknown>;
+    /** Answers with nothing to read: deletes, the cursor move, termination. */
+    readonly done: IResultStrategy<unknown>;
+    readonly watchpoints: IResultStrategy<unknown>;
+    /** The memory sizes and the snapshot's confirmation. */
+    readonly memory: IResultStrategy<unknown>;
+}
+/**
+ * The shipped default: every document as it arrived, and nothing where the
+ * answer carries nothing.
+ *
+ * `satisfies`, never an annotation — see `classDocuments` for why.
+ */
+export declare const abapDebuggerDocuments: {
+    breakpoints: IResultStrategy<string>;
+    listener: IResultStrategy<string>;
+    attach: IResultStrategy<string>;
+    stack: IResultStrategy<string>;
+    variables: IResultStrategy<string>;
+    step: IResultStrategy<string>;
+    done: IResultStrategy<void>;
+    watchpoints: IResultStrategy<string>;
+    memory: IResultStrategy<string>;
+};
+/** How this implementation behaves, fixed when it is constructed. */
+export interface IAbapDebuggerOptions {
+    /**
+     * When another listener already holds the user's debugging — an Eclipse,
+     * another agent: `refuse` (the default) is answered 409 and leaves it
+     * alone, `takeOver` displaces it. A consumer wanting both constructs two
+     * debuggers.
+     */
+    readonly onConflict?: IDebuggerListenerConflict;
+}
+type Of<R extends IAbapDebuggerResults, K extends keyof IAbapDebuggerResults> = ReturnType<R[K]>;
+export declare class AbapDebugger<R extends IAbapDebuggerResults = typeof abapDebuggerDocuments> implements IAbapDebugger<Of<R, 'breakpoints'>, Of<R, 'listener'>, Of<R, 'attach'>, Of<R, 'stack'>, Of<R, 'variables'>, Of<R, 'step'>, Of<R, 'done'>, Of<R, 'watchpoints'>, Of<R, 'memory'>> {
+    private readonly connection;
+    private readonly results;
+    private readonly options;
+    readonly kind: "abapDebugger";
+    constructor(connection: IAbapConnection, _logger?: ILogger, results?: R, options?: IAbapDebuggerOptions);
+    private reading;
+    setBreakpoints<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, breakpoints: readonly IDebuggerBreakpoint[], options?: {
+        validationOnly?: boolean;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'breakpoints'>, E>>;
+    deleteBreakpoint<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, breakpointId: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    listen<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, options?: {
+        holdSeconds?: number;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'listener'>, E>>;
+    stopListener<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    attach<E extends IAdtError = IAdtError>(requestUser: string, debuggeeId: string, options?: {
+        dynproDebugging?: boolean;
+        /** The debuggee's application server (`INSTANCE_NAME` in the listener's answer). */
+        server?: string;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'attach'>, E>>;
+    getStack<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'stack'>, E>>;
+    getChildVariables<E extends IAdtError = IAdtError>(parentIds: readonly string[], options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'variables'>, E>>;
+    getVariables<E extends IAdtError = IAdtError>(variableIds: readonly string[], options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'variables'>, E>>;
+    step<E extends IAdtError = IAdtError>(method: IDebuggerStepMethod, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'step'>, E>>;
+    stepToLine<E extends IAdtError = IAdtError>(method: IDebuggerStepToLineMethod, uri: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'step'>, E>>;
+    setStackPosition<E extends IAdtError = IAdtError>(position: number, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    setVariableValue<E extends IAdtError = IAdtError>(variableName: string, value: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'variables'>, E>>;
+    terminateDebuggee<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    createWatchpoint<E extends IAdtError = IAdtError>(variableName: string, options?: {
+        condition?: string;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'watchpoints'>, E>>;
+    listWatchpoints<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'watchpoints'>, E>>;
+    deleteWatchpoint<E extends IAdtError = IAdtError>(watchpointId: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    getMemorySizes<E extends IAdtError = IAdtError>(options?: {
+        includeAbap?: boolean;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'memory'>, E>>;
+    createMemorySnapshot<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'memory'>, E>>;
+}
+export {};
+//# sourceMappingURL=AbapDebugger.d.ts.map

package/dist/runtime/debugger/AbapDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbapDebugger.d.ts","sourceRoot":"","sources":["../../../src/runtime/debugger/AbapDebugger.ts"],"names":[],"mappings":"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"}

package/dist/runtime/debugger/AbapDebugger.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * AbapDebugger - Domain object for the standard ABAP debugger
+ *
+ * One member per request of the measured sequence in `./abap.ts`; the order,
+ * the stateful session and the second session that runs the program are the
+ * caller's.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbapDebugger = exports.abapDebuggerDocuments = void 0;
+const adtResponse_1 = require("../../utils/adtResponse");
+const resultStrategy_1 = require("../../utils/resultStrategy");
+const abap_1 = require("./abap");
+/**
+ * The shipped default: every document as it arrived, and nothing where the
+ * answer carries nothing.
+ *
+ * `satisfies`, never an annotation — see `classDocuments` for why.
+ */
+exports.abapDebuggerDocuments = {
+    breakpoints: resultStrategy_1.rawDocument,
+    listener: resultStrategy_1.rawDocument,
+    attach: resultStrategy_1.rawDocument,
+    stack: resultStrategy_1.rawDocument,
+    variables: resultStrategy_1.rawDocument,
+    step: resultStrategy_1.rawDocument,
+    done: resultStrategy_1.nothing,
+    watchpoints: resultStrategy_1.rawDocument,
+    memory: resultStrategy_1.rawDocument,
+};
+class AbapDebugger {
+    connection;
+    results;
+    options;
+    kind = 'abapDebugger';
+    constructor(connection, _logger, 
+    // The one cast in this file, and it is on the default. See AdtClass.
+    results = exports.abapDebuggerDocuments, options = {}) {
+        this.connection = connection;
+        this.results = results;
+        this.options = options;
+    }
+    reading(key) {
+        return this.results[key];
+    }
+    async setBreakpoints(identity, breakpoints, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.setBreakpoints)(this.connection, identity, breakpoints, options?.validationOnly), this.reading('breakpoints'), options?.analyse);
+    }
+    async deleteBreakpoint(identity, breakpointId, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.deleteBreakpoint)(this.connection, identity, breakpointId), this.reading('done'), options?.analyse);
+    }
+    async listen(identity, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.listen)(this.connection, identity, this.options.onConflict ?? 'refuse', options?.holdSeconds), this.reading('listener'), options?.analyse);
+    }
+    async stopListener(identity, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.stopListener)(this.connection, identity), this.reading('done'), options?.analyse);
+    }
+    async attach(requestUser, debuggeeId, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.attach)(this.connection, requestUser, debuggeeId, options?.dynproDebugging, options?.server), this.reading('attach'), options?.analyse);
+    }
+    async getStack(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.getStack)(this.connection), this.reading('stack'), options?.analyse);
+    }
+    async getChildVariables(parentIds, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.getChildVariables)(this.connection, parentIds), this.reading('variables'), options?.analyse);
+    }
+    async getVariables(variableIds, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.getVariables)(this.connection, variableIds), this.reading('variables'), options?.analyse);
+    }
+    async step(method, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.step)(this.connection, method), this.reading('step'), options?.analyse);
+    }
+    async stepToLine(method, uri, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.stepToLine)(this.connection, method, uri), this.reading('step'), options?.analyse);
+    }
+    async setStackPosition(position, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.setStackPosition)(this.connection, position), this.reading('done'), options?.analyse);
+    }
+    async setVariableValue(variableName, value, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.setVariableValue)(this.connection, variableName, value), this.reading('variables'), options?.analyse);
+    }
+    async terminateDebuggee(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.terminateDebuggee)(this.connection), this.reading('done'), options?.analyse);
+    }
+    async createWatchpoint(variableName, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.createWatchpoint)(this.connection, variableName, options?.condition), this.reading('watchpoints'), options?.analyse);
+    }
+    async listWatchpoints(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.listWatchpoints)(this.connection), this.reading('watchpoints'), options?.analyse);
+    }
+    async deleteWatchpoint(watchpointId, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.deleteWatchpoint)(this.connection, watchpointId), this.reading('done'), options?.analyse);
+    }
+    async getMemorySizes(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.getMemorySizes)(this.connection, options?.includeAbap), this.reading('memory'), options?.analyse);
+    }
+    async createMemorySnapshot(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.createMemorySnapshot)(this.connection), this.reading('memory'), options?.analyse);
+    }
+}
+exports.AbapDebugger = AbapDebugger;

package/dist/runtime/debugger/AmdpDebugger.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AmdpDebugger - Domain object for the AMDP debugger
+ *
+ * One member per request of the measured protocol in `./amdp.ts`. The two
+ * sessions — `start` and `getEvents` on one stateful connection, the commands
+ * on another — are the caller's: a consumer constructs one AmdpDebugger per
+ * connection.
+ */
+import type { IAdtAnalyseOptions, IAdtError, IAdtResponse, IAmdpBreakpoint, IAmdpDebugger, IAmdpStepMethod, IGetAmdpDataPreviewOptions, IResultStrategy, IStartAmdpDebuggerOptions } from '@mcp-abap-adt/interfaces-adt';
+import type { IAbapConnection } from '@mcp-abap-adt/interfaces-adt-connection';
+import type { ILogger } from '@mcp-abap-adt/interfaces-utils';
+/** One strategy per kind of answer the AMDP debugger gives. */
+export interface IAmdpDebuggerResults {
+    /** The start: `Location` names the session, the body the database session. */
+    readonly started: IResultStrategy<unknown>;
+    /** The events document. */
+    readonly events: IResultStrategy<unknown>;
+    /** A command's answer: `Location` carries its request id, the body is empty. */
+    readonly command: IResultStrategy<unknown>;
+    readonly preview: IResultStrategy<unknown>;
+}
+/**
+ * The shipped default: the start and the commands answered whole — what
+ * they say is in a header — and the documents as they arrived.
+ *
+ * `satisfies`, never an annotation — see `classDocuments` for why.
+ */
+export declare const amdpDebuggerDocuments: {
+    started: IResultStrategy<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<unknown, unknown>>;
+    events: IResultStrategy<string>;
+    command: IResultStrategy<import("@mcp-abap-adt/interfaces-adt-connection").IAdtWireResponse<unknown, unknown>>;
+    preview: IResultStrategy<string>;
+};
+type Of<R extends IAmdpDebuggerResults, K extends keyof IAmdpDebuggerResults> = ReturnType<R[K]>;
+export declare class AmdpDebugger<R extends IAmdpDebuggerResults = typeof amdpDebuggerDocuments> implements IAmdpDebugger<Of<R, 'started'>, Of<R, 'events'>, Of<R, 'command'>, Of<R, 'preview'>> {
+    private readonly connection;
+    private readonly results;
+    readonly kind: "amdpDebugger";
+    constructor(connection: IAbapConnection, _logger?: ILogger, results?: R);
+    private reading;
+    start<E extends IAdtError = IAdtError>(requestUser: string, options?: IStartAmdpDebuggerOptions & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'started'>, E>>;
+    syncBreakpoints<E extends IAdtError = IAdtError>(mainId: string, breakpoints: readonly IAmdpBreakpoint[], options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'command'>, E>>;
+    getEvents<E extends IAdtError = IAdtError>(mainId: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'events'>, E>>;
+    step<E extends IAdtError = IAdtError>(mainId: string, debuggeeId: string, step: IAmdpStepMethod, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'command'>, E>>;
+    deleteDebuggee<E extends IAdtError = IAdtError>(mainId: string, debuggeeId: string, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'command'>, E>>;
+    stop<E extends IAdtError = IAdtError>(mainId: string, options?: {
+        hardStop?: boolean;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'command'>, E>>;
+    getDataPreview<E extends IAdtError = IAdtError>(options: IGetAmdpDataPreviewOptions & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'preview'>, E>>;
+}
+export {};
+//# sourceMappingURL=AmdpDebugger.d.ts.map

package/dist/runtime/debugger/AmdpDebugger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmdpDebugger.d.ts","sourceRoot":"","sources":["../../../src/runtime/debugger/AmdpDebugger.ts"],"names":[],"mappings":"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"}

package/dist/runtime/debugger/AmdpDebugger.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * AmdpDebugger - Domain object for the AMDP debugger
+ *
+ * One member per request of the measured protocol in `./amdp.ts`. The two
+ * sessions — `start` and `getEvents` on one stateful connection, the commands
+ * on another — are the caller's: a consumer constructs one AmdpDebugger per
+ * connection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmdpDebugger = exports.amdpDebuggerDocuments = void 0;
+const adtResponse_1 = require("../../utils/adtResponse");
+const resultStrategy_1 = require("../../utils/resultStrategy");
+const amdp_1 = require("./amdp");
+const amdpDataPreview_1 = require("./amdpDataPreview");
+/**
+ * The shipped default: the start and the commands answered whole — what
+ * they say is in a header — and the documents as they arrived.
+ *
+ * `satisfies`, never an annotation — see `classDocuments` for why.
+ */
+exports.amdpDebuggerDocuments = {
+    started: resultStrategy_1.wireItself,
+    events: resultStrategy_1.rawDocument,
+    command: resultStrategy_1.wireItself,
+    preview: resultStrategy_1.rawDocument,
+};
+class AmdpDebugger {
+    connection;
+    results;
+    kind = 'amdpDebugger';
+    constructor(connection, _logger, 
+    // The one cast in this file, and it is on the default. See AdtClass.
+    results = exports.amdpDebuggerDocuments) {
+        this.connection = connection;
+        this.results = results;
+    }
+    reading(key) {
+        return this.results[key];
+    }
+    async start(requestUser, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.startAmdpDebugger)(this.connection, requestUser, options), this.reading('started'), options?.analyse);
+    }
+    async syncBreakpoints(mainId, breakpoints, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.syncAmdpBreakpoints)(this.connection, mainId, breakpoints), this.reading('command'), options?.analyse);
+    }
+    async getEvents(mainId, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.getAmdpEvents)(this.connection, mainId), this.reading('events'), options?.analyse);
+    }
+    async step(mainId, debuggeeId, step, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.stepAmdpDebuggee)(this.connection, mainId, debuggeeId, step), this.reading('command'), options?.analyse);
+    }
+    async deleteDebuggee(mainId, debuggeeId, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.deleteAmdpDebuggee)(this.connection, mainId, debuggeeId), this.reading('command'), options?.analyse);
+    }
+    async stop(mainId, options) {
+        return (0, adtResponse_1.answering)(() => (0, amdp_1.stopAmdpDebugger)(this.connection, mainId, options?.hardStop), this.reading('command'), options?.analyse);
+    }
+    async getDataPreview(options) {
+        return (0, adtResponse_1.answering)(() => (0, amdpDataPreview_1.getAmdpDataPreview)(this.connection, options), this.reading('preview'), options.analyse);
+    }
+}
+exports.AmdpDebugger = AmdpDebugger;