@mcp-abap-adt/adt-clients 27.0.0 → 29.0.0

package/README.md

@@ -91,8 +91,8 @@ This package interacts with external packages **ONLY through interfaces**:
 
   | package | what this package takes from it |
   |---|---|
-  | [`@mcp-abap-adt/interfaces-adt`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-adt) `^12.0.0` | the capability atoms, every object's config, `IAdtResponse`, `IAnalyse`, `IAdtAnalyseOptions`, `IResultStrategy`, `ADT_NO_FAILURE`, `ADT_TASK_TYPE` |
-  | [`@mcp-abap-adt/interfaces-adt-connection`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-adt-connection) `^1.0.0` | `IAbapConnection`, `IAdtWireResponse`, `IAbapRequestOptions`, `ITimeoutConfig`, the connection capability atoms, `ADT_SESSION_ERROR` |
+  | [`@mcp-abap-adt/interfaces-adt`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-adt) `^15.0.0` | the capability atoms, every object's config, `IAdtResponse`, `IAnalyse`, `IAdtAnalyseOptions`, `IResultStrategy`, `ADT_NO_FAILURE`, `ADT_TASK_TYPE` |
+  | [`@mcp-abap-adt/interfaces-adt-connection`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-adt-connection) `^2.0.0` | `IAbapConnection`, `IAdtWireResponse`, `IAbapRequestOptions`, `ITimeoutConfig`, the connection capability atoms, `ADT_SESSION_ERROR` |
   | [`@mcp-abap-adt/interfaces-network`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-network) `^2.0.0` | `IWebSocketTransport` and its four companions, `HttpError` |
   | [`@mcp-abap-adt/interfaces-utils`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-utils) `^1.1.0` | `ILogger`, `LogLevel`, `XmlNode` |
   | [`@mcp-abap-adt/interfaces-auth`](https://www.npmjs.com/package/@mcp-abap-adt/interfaces-auth) — **dev only** | `IAuthProvider`, for the test helpers that open a session |
@@ -162,7 +162,9 @@ npm install @mcp-abap-adt/adt-clients
 
 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`
+   - One member per request, contracts `IAbapDebugger`, `IAmdpDebugger`, `IMemorySnapshots` from `@mcp-abap-adt/interfaces-adt` (contract 15 pairs with clients 29)
+   - **The identity states its mode.** `{ debuggingMode: 'user', requestUser, terminalId, ideId }`, or `{ debuggingMode: 'terminal', terminalId, ideId }`; `attach` takes the identity, not the user. A catch in terminal mode is unmeasured
+   - **Breakpoints are replaced, not added to.** `setBreakpoints` and `syncBreakpoints` replace the identity's set, and `stopListener` deletes it: arm the whole set in one call
    - **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)
 
@@ -534,7 +536,7 @@ await client.getBehaviorImplementation().create(
     packageName: 'ZOK_TEST_PKG_01',
     behaviorDefinition: 'ZOK_I_CDS_TEST',
     description: 'Behavior Implementation for ZOK_I_CDS_TEST',
-    transportRequest: 'E19K900001'
+    transportRequest: 'DEVK900001'
   }
 );
 // The class shell exists. Its `source/main` — the generated binding to the
@@ -855,7 +857,7 @@ everything else is not.
 
 ### Single Definition Site: the contract packages
 
-Since **7.5.0**, every contract type is **defined once**, in the contract packages — today `@mcp-abap-adt/interfaces-adt` (`^12.0.0`) for the ADT contracts and `@mcp-abap-adt/interfaces-adt-connection` (`^1.0.0`) for the connection. This package declares no copies of its own — every `IXxxConfig`, the capability atoms, the option and response types and the cross-cutting shared types all live there.
+Since **7.5.0**, every contract type is **defined once**, in the contract packages — today `@mcp-abap-adt/interfaces-adt` (`^15.0.0`) for the ADT contracts and `@mcp-abap-adt/interfaces-adt-connection` (`^2.0.0`) for the connection. This package declares no copies of its own — every `IXxxConfig`, the capability atoms, the option and response types and the cross-cutting shared types all live there.
 
 **Import them from the package that owns them:**
 
@@ -935,7 +937,7 @@ 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.
 
-> **Version pairing.** Because the types are sourced rather than copied, `@mcp-abap-adt/interfaces-adt` and `@mcp-abap-adt/interfaces-adt-connection` are hard peers of this package's public API. A major bump there implies a bump here; keep the two in step rather than letting a resolver pick a mismatched pair.
+> **Version pairing.** `adt-clients` 29 pairs with `interfaces-adt` 15 (breakpoints lose `skipCount` and gain `clientId`), and `adt-strategies` 0.10.0 declares the same range. Because the types are sourced rather than copied, `@mcp-abap-adt/interfaces-adt` and `@mcp-abap-adt/interfaces-adt-connection` are hard peers of this package's public API. A major bump there implies a bump here; keep the two in step rather than letting a resolver pick a mismatched pair.
 
 ### Naming Conventions
 

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

@@ -34,7 +34,7 @@ import type { IUpdateBehaviorDefinitionParams } from './types';
  *   name: 'Z_MY_BDEF',
  *   sourceCode: source,
  *   lockHandle,
- *   transportRequest: 'E19K905635'
+ *   transportRequest: 'DEVK905635'
  * });
  * await unlock(connection, 'Z_MY_BDEF', lockHandle, sessionId);
  * ```

package/dist/core/behaviorDefinition/update.js

@@ -39,7 +39,7 @@ const timeouts_1 = require("../../utils/timeouts");
  *   name: 'Z_MY_BDEF',
  *   sourceCode: source,
  *   lockHandle,
- *   transportRequest: 'E19K905635'
+ *   transportRequest: 'DEVK905635'
  * });
  * await unlock(connection, 'Z_MY_BDEF', lockHandle, sessionId);
  * ```

package/dist/core/metadataExtension/create.d.ts

@@ -19,7 +19,7 @@ import type { IMetadataExtensionCreateParams } from './types';
  *   name: 'ZDEMO_C_CDS_MDE',
  *   description: 'First metadata extension',
  *   packageName: 'ZDEMO_PKG',
- *   transportRequest: 'TRLK900123'
+ *   transportRequest: 'DEVK900123'
  * }, sessionId);
  * ```
  */

package/dist/core/metadataExtension/create.js

@@ -24,7 +24,7 @@ const timeouts_1 = require("../../utils/timeouts");
  *   name: 'ZDEMO_C_CDS_MDE',
  *   description: 'First metadata extension',
  *   packageName: 'ZDEMO_PKG',
- *   transportRequest: 'TRLK900123'
+ *   transportRequest: 'DEVK900123'
  * }, sessionId);
  * ```
  */

package/dist/core/metadataExtension/delete.d.ts

@@ -15,7 +15,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
  *
  * @example
  * ```typescript
- * await deleteMetadataExtension(connection, 'ZDEMO_C_CDS_MDE', 'TRLK900123', sessionId);
+ * await deleteMetadataExtension(connection, 'ZDEMO_C_CDS_MDE', 'DEVK900123', sessionId);
  * ```
  */
 export declare function deleteMetadataExtension(connection: IAbapConnection, name: string, transportRequest: string | undefined): Promise<IAdtWireResponse>;

package/dist/core/metadataExtension/delete.js

@@ -19,7 +19,7 @@ const timeouts_1 = require("../../utils/timeouts");
  *
  * @example
  * ```typescript
- * await deleteMetadataExtension(connection, 'ZDEMO_C_CDS_MDE', 'TRLK900123', sessionId);
+ * await deleteMetadataExtension(connection, 'ZDEMO_C_CDS_MDE', 'DEVK900123', sessionId);
  * ```
  */
 async function deleteMetadataExtension(connection, name, transportRequest) {

package/dist/core/transport/AdtRequest.d.ts

@@ -154,12 +154,12 @@ export declare class AdtRequest<R extends ITransportResults = typeof transportDo
      *
      * ```typescript
      * const request = client.getRequest();
-     * await request.removeObject('E19K905942', {
+     * await request.removeObject('DEVK905942', {
      *   name: 'ZMCP_BLD_FGR_H1',
      *   type: 'FUGR',
      *   position: '000025',
      * });
-     * const log = await request.readActionLog('E19K905942');
+     * const log = await request.readActionLog('DEVK905942');
      * ```
      *
      * **`position` is required, and it is what makes the call do anything.**

package/dist/core/transport/AdtRequest.js

@@ -212,12 +212,12 @@ class AdtRequest {
      *
      * ```typescript
      * const request = client.getRequest();
-     * await request.removeObject('E19K905942', {
+     * await request.removeObject('DEVK905942', {
      *   name: 'ZMCP_BLD_FGR_H1',
      *   type: 'FUGR',
      *   position: '000025',
      * });
-     * const log = await request.readActionLog('E19K905942');
+     * const log = await request.readActionLog('DEVK905942');
      * ```
      *
      * **`position` is required, and it is what makes the call do anything.**

package/dist/index.runtime.d.ts

@@ -9,7 +9,7 @@ export { AtcLog, atcLogDocuments, type IAtcLogResults, } from './runtime/atc/Atc
 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 { type IDebuggerListenerConflict, readListenerConflict, } 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';

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;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;AAE1C,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,OAAO,EACL,KAAK,yBAAyB,EAC9B,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAEjC,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;AAE1C,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.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;
+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.readListenerConflict = 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");
@@ -28,6 +28,8 @@ Object.defineProperty(exports, "abapDebuggerDocuments", { enumerable: true, get:
 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; } });
+var abap_1 = require("./runtime/debugger/abap");
+Object.defineProperty(exports, "readListenerConflict", { enumerable: true, get: function () { return abap_1.readListenerConflict; } });
 // 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; } });

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

@@ -5,7 +5,7 @@
  * 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 { IAbapDebugger, IAdtAnalyseOptions, IAdtError, IAdtResponse, IDebuggerBreakpoint, IDebuggerBreakpointSync, IDebuggerIdentity, IDebuggerSettings, 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';
@@ -22,6 +22,8 @@ export interface IAbapDebuggerResults {
     readonly watchpoints: IResultStrategy<unknown>;
     /** The memory sizes and the snapshot's confirmation. */
     readonly memory: IResultStrategy<unknown>;
+    /** The debugger settings' confirmation. */
+    readonly settings: IResultStrategy<unknown>;
 }
 /**
  * The shipped default: every document as it arrived, and nothing where the
@@ -39,6 +41,7 @@ export declare const abapDebuggerDocuments: {
     done: IResultStrategy<void>;
     watchpoints: IResultStrategy<string>;
     memory: IResultStrategy<string>;
+    settings: IResultStrategy<string>;
 };
 /** How this implementation behaves, fixed when it is constructed. */
 export interface IAbapDebuggerOptions {
@@ -51,22 +54,63 @@ export interface IAbapDebuggerOptions {
     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'>> {
+/**
+ * The ABAP debugger on one connection, with the settings it was constructed
+ * with (`onConflict`).
+ *
+ * **One debug session per identity.** The server binds the listener context -
+ * request user and IDE id - to the ABAP session the connection carries (see
+ * `listen` in `abap.ts`), so one debugger serves one identity. Another
+ * identity - another request user, another mode, another `ideId` - needs
+ * another debug session: a new `AbapDebugger` on a connection of its own,
+ * with its own settings. The library does not guard this; a call naming an
+ * identity other than the one the session was bound to is answered by the
+ * server as it is.
+ */
+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'>, Of<R, 'settings'>> {
     private readonly connection;
     private readonly results;
     private readonly options;
     readonly kind: "abapDebugger";
     constructor(connection: IAbapConnection, _logger?: ILogger, results?: R, options?: IAbapDebuggerOptions);
     private reading;
+    /**
+     * Arm breakpoints under the identity's key, replacing what the key held -
+     * a `validationOnly` request too (see `setBreakpoints` in `abap.ts`).
+     *
+     * `clientId` on a breakpoint tags it; the server echoes it on every answer
+     * row, placed and refused, in an order of its own (see `setBreakpoints` in
+     * `abap.ts`).
+     */
     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>>;
+    /**
+     * Start a listener for the identity, with the conflict behaviour this
+     * debugger was constructed with (`onConflict`).
+     *
+     * The listener belongs to the identity's debug session: a listener for
+     * another identity needs a new `AbapDebugger` on a connection of its own
+     * (see the class and `listen` in `abap.ts`).
+     */
     listen<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, options?: {
         holdSeconds?: number;
     } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'listener'>, E>>;
+    /**
+     * Release the listener - and delete the key's breakpoints with it, whether
+     * or not a listener was running (see `stopListener` in `abap.ts`). Stop the
+     * listener last, or arm again before the next listen. It acts for the
+     * identity's debug session; another identity needs a debugger of its own.
+     */
     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?: {
+    /**
+     * Attach to the debuggee a listener caught. The attach, and everything after
+     * it, goes on a debugger with a connection opened for this debuggee, never
+     * the listener's (see `attach` in `abap.ts`); the identity is the one the
+     * session was bound to - another identity needs a debugger of its own.
+     */
+    attach<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, debuggeeId: string, options?: {
         dynproDebugging?: boolean;
         /** The debuggee's application server (`INSTANCE_NAME` in the listener's answer). */
         server?: string;
@@ -88,6 +132,34 @@ export declare class AbapDebugger<R extends IAbapDebuggerResults = typeof abapDe
         includeAbap?: boolean;
     } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'memory'>, E>>;
     createMemorySnapshot<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'memory'>, E>>;
+    /**
+     * Replace the key's breakpoints, `full` or by object with `partial` (see
+     * `syncBreakpoints` in `abap.ts`).
+     *
+     * `clientId` on a breakpoint tags it; the server echoes it on every answer
+     * row, placed and refused, in an order of its own (see `setBreakpoints` in
+     * `abap.ts`).
+     */
+    syncBreakpoints<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, sync: IDebuggerBreakpointSync, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'breakpoints'>, E>>;
+    /**
+     * Ask whether a listener for the identity would conflict; starts nothing.
+     * The answer is read in the identity's debug session: for another identity,
+     * use a debugger on a connection of its own (see the class).
+     */
+    checkListener<E extends IAdtError = IAdtError>(identity: IDebuggerIdentity, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    detachDebugger<E extends IAdtError = IAdtError>(options?: {
+        debuggeeId?: string;
+    } & IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    /**
+     * Free the debugger; the program runs on. SAP answers it with a plain ICF
+     * `500` (no ADT exception document) when it worked: pass
+     * `analyseDebuggerFreed` from `@mcp-abap-adt/adt-strategies` (0.9.0) to take
+     * that `500` as no failure, or `analyseException` to let it stop you. See
+     * the errata entry "The debugger freeing its session is answered as an ICF
+     * 500" and `terminateDebugger` in `abap.ts`.
+     */
+    terminateDebugger<E extends IAdtError = IAdtError>(options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'done'>, E>>;
+    setDebuggerSettings<E extends IAdtError = IAdtError>(settings: IDebuggerSettings, options?: IAdtAnalyseOptions<E>): Promise<IAdtResponse<Of<R, 'settings'>, E>>;
 }
 export {};
 //# sourceMappingURL=AbapDebugger.d.ts.map

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

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

@@ -27,7 +27,21 @@ exports.abapDebuggerDocuments = {
     done: resultStrategy_1.nothing,
     watchpoints: resultStrategy_1.rawDocument,
     memory: resultStrategy_1.rawDocument,
+    settings: resultStrategy_1.rawDocument,
 };
+/**
+ * The ABAP debugger on one connection, with the settings it was constructed
+ * with (`onConflict`).
+ *
+ * **One debug session per identity.** The server binds the listener context -
+ * request user and IDE id - to the ABAP session the connection carries (see
+ * `listen` in `abap.ts`), so one debugger serves one identity. Another
+ * identity - another request user, another mode, another `ideId` - needs
+ * another debug session: a new `AbapDebugger` on a connection of its own,
+ * with its own settings. The library does not guard this; a call naming an
+ * identity other than the one the session was bound to is answered by the
+ * server as it is.
+ */
 class AbapDebugger {
     connection;
     results;
@@ -43,20 +57,48 @@ class AbapDebugger {
     reading(key) {
         return this.results[key];
     }
+    /**
+     * Arm breakpoints under the identity's key, replacing what the key held -
+     * a `validationOnly` request too (see `setBreakpoints` in `abap.ts`).
+     *
+     * `clientId` on a breakpoint tags it; the server echoes it on every answer
+     * row, placed and refused, in an order of its own (see `setBreakpoints` in
+     * `abap.ts`).
+     */
     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);
     }
+    /**
+     * Start a listener for the identity, with the conflict behaviour this
+     * debugger was constructed with (`onConflict`).
+     *
+     * The listener belongs to the identity's debug session: a listener for
+     * another identity needs a new `AbapDebugger` on a connection of its own
+     * (see the class and `listen` in `abap.ts`).
+     */
     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);
     }
+    /**
+     * Release the listener - and delete the key's breakpoints with it, whether
+     * or not a listener was running (see `stopListener` in `abap.ts`). Stop the
+     * listener last, or arm again before the next listen. It acts for the
+     * identity's debug session; another identity needs a debugger of its own.
+     */
     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);
+    /**
+     * Attach to the debuggee a listener caught. The attach, and everything after
+     * it, goes on a debugger with a connection opened for this debuggee, never
+     * the listener's (see `attach` in `abap.ts`); the identity is the one the
+     * session was bound to - another identity needs a debugger of its own.
+     */
+    async attach(identity, debuggeeId, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.attach)(this.connection, identity, 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);
@@ -97,5 +139,41 @@ class AbapDebugger {
     async createMemorySnapshot(options) {
         return (0, adtResponse_1.answering)(() => (0, abap_1.createMemorySnapshot)(this.connection), this.reading('memory'), options?.analyse);
     }
+    /**
+     * Replace the key's breakpoints, `full` or by object with `partial` (see
+     * `syncBreakpoints` in `abap.ts`).
+     *
+     * `clientId` on a breakpoint tags it; the server echoes it on every answer
+     * row, placed and refused, in an order of its own (see `setBreakpoints` in
+     * `abap.ts`).
+     */
+    async syncBreakpoints(identity, sync, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.syncBreakpoints)(this.connection, identity, sync), this.reading('breakpoints'), options?.analyse);
+    }
+    /**
+     * Ask whether a listener for the identity would conflict; starts nothing.
+     * The answer is read in the identity's debug session: for another identity,
+     * use a debugger on a connection of its own (see the class).
+     */
+    async checkListener(identity, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.checkListener)(this.connection, identity), this.reading('done'), options?.analyse);
+    }
+    async detachDebugger(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.detachDebugger)(this.connection, options?.debuggeeId), this.reading('done'), options?.analyse);
+    }
+    /**
+     * Free the debugger; the program runs on. SAP answers it with a plain ICF
+     * `500` (no ADT exception document) when it worked: pass
+     * `analyseDebuggerFreed` from `@mcp-abap-adt/adt-strategies` (0.9.0) to take
+     * that `500` as no failure, or `analyseException` to let it stop you. See
+     * the errata entry "The debugger freeing its session is answered as an ICF
+     * 500" and `terminateDebugger` in `abap.ts`.
+     */
+    async terminateDebugger(options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.terminateDebugger)(this.connection), this.reading('done'), options?.analyse);
+    }
+    async setDebuggerSettings(settings, options) {
+        return (0, adtResponse_1.answering)(() => (0, abap_1.setDebuggerSettings)(this.connection, settings), this.reading('settings'), options?.analyse);
+    }
 }
 exports.AbapDebugger = AbapDebugger;