@mcp-abap-adt/interfaces-adt 13.0.0 → 13.2.0

package/CHANGELOG.md

@@ -7,6 +7,66 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [13.2.0] - 2026-10-10
+
+### Added
+
+- **The service binding's two reads beyond its lifecycle, as atoms.** Until now
+  a binding's handler could only be typed by its implementation, because these
+  members had no contract (`adt-clients` #109).
+  - `IAdtServiceBindingTypes` — `getServiceBindingTypes`: the binding types the
+    system offers, a catalogue (`nameditem:namedItemList`).
+  - `IAdtServiceGroupReadable` — `getServiceGroup(params)`: the service group a
+    binding publishes, its URL prefix, services and publication state. A read,
+    which is what tells a publication's outcome — not a job, not a generation.
+  - `IServiceGroupParams`, the read's argument, moves here from
+    `adt-clients`, which declared it locally.
+
+  Measured on premise and on SAP BTP ABAP Environment (2026-10-10). Every
+  member takes the error strategy with the call; both are in
+  `errorStrategyOnEveryMember`.
+
+## [13.1.0] - 2026-10-10
+
+### Added
+
+- **The debugger contracts, measured.** Withdrawn from `@mcp-abap-adt/interfaces`
+  in 30.0.0 until they could come back "measured: one member per endpoint";
+  they were measured on premise (HTTP and RFC) and on SAP BTP ABAP
+  Environment, and come back here.
+  - `IAbapDebugger` — the ABAP debugger in user mode: breakpoints, listener,
+    attach, stack, variables, steps, watchpoints, a value set, termination,
+    and the debuggee's memory (sizes, and a snapshot written).
+    `IDebuggerIdentity`, `IDebuggerBreakpoint`, `IDebuggerStepMethod`,
+    `IDebuggerStepToLineMethod`, `IAttachOptions`.
+  - `IAmdpDebugger` — the AMDP debugger, a protocol of its own: session,
+    breakpoints, events, steps, a debuggee ended, stop, and a table
+    variable's rows. `IAmdpBreakpoint`, `IAmdpStepMethod`,
+    `IStartAmdpDebuggerOptions`, `IGetAmdpDataPreviewOptions`.
+  - `IMemorySnapshots` — the memory snapshots the system lists, each view of
+    one and the deltas between two. `IMemorySnapshotsListOptions`,
+    `ISnapshotRankingListOptions`, `ISnapshotChildrenOptions`,
+    `ISnapshotReferencesOptions`.
+
+  What the measurement decided in the shape:
+  - **Two sessions.** The ABAP listener holds one; each debuggee caught is
+    attached on another, named by its application server. On a system with
+    more than one server an attach on the listener's session is refused
+    whenever the debuggee runs elsewhere. The AMDP debugger likewise answers
+    its events on one session and takes its commands on another.
+  - **Run to a line takes the line as an argument.** Without it SAP answers
+    400, and on one release (BASIS 758) the program ran to its end in the
+    same moment, losing the stop; on BASIS 816 and on SAP BTP ABAP
+    Environment it stayed suspended.
+  - **Jump to a line is measured too**: it moves the debuggee to the line
+    without running what lies between.
+  - **The snapshot views take their limit as required.** Without
+    `maxNumberOfObjects` or `maxNumberOfReferences` they answer 400.
+  - **Every member takes the error strategy with the call** (decision 36),
+    and `errorStrategyOnEveryMember` now holds the three contracts to it.
+  - Every type parameter is the implementation's, with no default, as in the
+    other runtime contracts.
+
 ## [13.0.0] - 2026-10-05
 
 ### Changed (breaking)

package/README.md

@@ -22,7 +22,7 @@ npm install @mcp-abap-adt/interfaces-adt
 | directory | files | what |
 |---|---|---|
 | `adt/` | 39 | the object contracts: capability atoms, the object types, `IAdtResponse`, `IAdtError`, the error codes, the transport request's object list |
-| `runtime/` | 11 | runtime analysis: `IProfiler`, the trace contracts (`ITraceListing`/`ITraceReading`, `ICrossTrace`, `ISt05Trace`), `IApplicationLog`, `IAtcLog` and the ATC run (`IAtcRunOptions`, `IAtcFindings`), `IDdicActivation`, `IGatewayErrorLog`, `IRuntimeDumps`, `ISystemMessages` |
+| `runtime/` | 14 | runtime analysis: the debuggers (`IAbapDebugger`, `IAmdpDebugger`) and `IMemorySnapshots`, `IProfiler`, the trace contracts (`ITraceListing`/`ITraceReading`, `ICrossTrace`, `ISt05Trace`), `IApplicationLog`, `IAtcLog` and the ATC run (`IAtcRunOptions`, `IAtcFindings`), `IDdicActivation`, `IGatewayErrorLog`, `IRuntimeDumps`, `ISystemMessages` |
 | `execution/` | 3 | class and program execution, with profiling |
 | `feeds/` | 2 | the ADT feed contracts |
 | `service/` | 1 | service definitions and bindings |

package/dist/adt/IAdtServiceBinding.d.ts

@@ -1,6 +1,8 @@
 /**
  * Service Binding ADT operation parameter interfaces (snake_case, low-level)
  */
+import type { IAdtAnalyseOptions, IAnalyse } from './IAdtObject';
+import type { IAdtError, IAdtResponse } from './IAdtResponse';
 export type ServiceBindingType = 'ODATA' | 'INA' | 'SQL';
 export type ServiceBindingVersion = 'V2' | 'V4' | '0001' | '0000' | string;
 export type GeneratedServiceType = 'odatav2' | 'odatav4';
@@ -42,4 +44,38 @@ export interface IServiceBindingConfig {
     serviceType?: GeneratedServiceType;
     transportRequest?: string;
 }
+/** Which service group to read: the binding, and the service it exposes. */
+export interface IServiceGroupParams {
+    /** The binding, as the URL addresses it. */
+    objectname: string;
+    /** Which protocol's service group to read. */
+    serviceType: GeneratedServiceType;
+    servicename?: string;
+    serviceversion?: string;
+    srvdname?: string;
+}
+type WithAnalyse<E extends IAdtError, O = unknown> = O & IAdtAnalyseOptions<E> & {
+    analyse: IAnalyse<E>;
+};
+type WithoutAnalyse<O = unknown> = O & IAdtAnalyseOptions;
+/**
+ * The binding types the system offers — a catalogue, not a binding: the same
+ * answer whichever binding asks. Measured on premise and on the cloud
+ * (2026-10-10): a `nameditem:namedItemList` of six entries.
+ */
+export interface IAdtServiceBindingTypes<TTypes> {
+    getServiceBindingTypes<E extends IAdtError>(options: WithAnalyse<E>): Promise<IAdtResponse<TTypes, E>>;
+    getServiceBindingTypes(options?: WithoutAnalyse): Promise<IAdtResponse<TTypes>>;
+}
+/**
+ * The service group a binding publishes: its URL prefix, its services and
+ * whether they are published. A read of that object — it is what is read
+ * after a publication to learn its outcome, not a job and not a generation.
+ * Measured on premise and on the cloud (2026-10-10).
+ */
+export interface IAdtServiceGroupReadable<TGroup> {
+    getServiceGroup<E extends IAdtError>(params: IServiceGroupParams, options: WithAnalyse<E>): Promise<IAdtResponse<TGroup, E>>;
+    getServiceGroup(params: IServiceGroupParams, options?: WithoutAnalyse): Promise<IAdtResponse<TGroup>>;
+}
+export {};
 //# sourceMappingURL=IAdtServiceBinding.d.ts.map

package/dist/adt/IAdtServiceBinding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IAdtServiceBinding.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtServiceBinding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,qBAAqB,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,CAAC;AACzD,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,kBAAkB,GAClB,aAAa,GACb,kBAAkB,CAAC;AAGvB,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAC9C,qBAAqB,EACrB;IACE,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,EAAE,qBAAqB,CAAC;IACtC,eAAe,EAAE,GAAG,GAAG,GAAG,CAAC;IAC3B,WAAW,EAAE,oBAAoB,CAAC;CACnC,CA0BF,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,qBAAqB,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,qBAAqB,CAAC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;IAClD,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}
+{"version":3,"file":"IAdtServiceBinding.d.ts","sourceRoot":"","sources":["../../src/adt/IAdtServiceBinding.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -44,7 +44,7 @@ export type { AdtFailureOrigin, AdtNoFailure, IAdtError, IAdtFailure, IAdtRespon
 export { ADT_NO_FAILURE } from './adt/IAdtResponse';
 export type { IScalarFunctionConfig } from './adt/IAdtScalarFunction';
 export type { IScalarFunctionImplementationConfig, ScalarFunctionEngine, } from './adt/IAdtScalarFunctionImplementation';
-export type { DesiredPublicationState, GeneratedServiceType, ICreateServiceBindingParams, IServiceBindingConfig, ServiceBindingType, ServiceBindingVariant, ServiceBindingVersion, } from './adt/IAdtServiceBinding';
+export type { DesiredPublicationState, GeneratedServiceType, IAdtServiceBindingTypes, IAdtServiceGroupReadable, ICreateServiceBindingParams, IServiceBindingConfig, IServiceGroupParams, ServiceBindingType, ServiceBindingVariant, ServiceBindingVersion, } from './adt/IAdtServiceBinding';
 export { SERVICE_BINDING_VARIANT_MAP } from './adt/IAdtServiceBinding';
 export type { IServiceDefinitionConfig } from './adt/IAdtServiceDefinition';
 export type { AdtObjectType, AdtObjectTypeLower, AdtSourceObjectType, AdtSourceObjectTypeLower, IGetDiscoveryParams, IGetSqlQueryParams, IGetTableContentsParams, IGetVirtualFoldersContentsParams, IGetWhereUsedParams, IGetWhereUsedScopeParams, IObjectReference, ISearchObjectsParams, IVirtualFoldersPreselection, } from './adt/IAdtShared';
@@ -61,12 +61,15 @@ export type { IAdtRunnable, IRunnableWithProfiler, IRunnableWithProfiling, } fro
 export type { ITraceScheduling } from './execution/ITraceScheduling';
 export type { IFeedRepository } from './feeds/IFeedRepository';
 export type { IAbapTimestamp, IFeedQueryOptions } from './feeds/types';
+export type { IAbapDebugger, IAttachOptions, IDebuggerBreakpoint, IDebuggerIdentity, IDebuggerStepMethod, IDebuggerStepToLineMethod, } from './runtime/IAbapDebugger';
+export type { IAmdpBreakpoint, IAmdpDebugger, IAmdpStepMethod, IGetAmdpDataPreviewOptions, IStartAmdpDebuggerOptions, } from './runtime/IAmdpDebugger';
 export type { IApplicationLog, IGetApplicationLogObjectOptions, IGetApplicationLogSourceOptions, } from './runtime/IApplicationLog';
 export type { IAtcLog, IGetCheckFailureLogsOptions } from './runtime/IAtcLog';
 export type { AtcClassIncludeKind, AtcNamedObjectType, AtcObjectType, IAtcFindings, IAtcObjectRef, IAtcRunOptions, IAtcRunStatusReadable, IAtcRunTarget, } from './runtime/IAtcRun';
 export type { ICrossTrace, ICrossTraceResults, IListCrossTracesOptions, } from './runtime/ICrossTrace';
 export type { IDdicActivation, IGetActivationGraphOptions, } from './runtime/IDdicActivation';
 export type { IGatewayErrorLog } from './runtime/IGatewayErrorLog';
+export type { IMemorySnapshots, IMemorySnapshotsListOptions, ISnapshotChildrenOptions, ISnapshotRankingListOptions, ISnapshotReferencesOptions, } from './runtime/IMemorySnapshots';
 export type { IProfiler, IProfilerListOptions, IProfilerTraceDbAccessesOptions, IProfilerTraceHitListOptions, IProfilerTraceParameters, IProfilerTraceStatementsOptions, } from './runtime/IProfiler';
 export type { IRuntimeDumpReadOptions, IRuntimeDumpReadView, IRuntimeDumps, IRuntimeDumpsListOptions, } from './runtime/IRuntimeDumps';
 export type { ISt05Trace } from './runtime/ISt05Trace';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,+BAA+B,EAC/B,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,YAAY,EACV,oCAAoC,EACpC,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACtF,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,YAAY,EACZ,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,aAAa,EACb,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,eAAe,EACf,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACxE,YAAY,EACV,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EACV,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EACV,mCAAmC,EACnC,oBAAoB,GACrB,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAC5E,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,gCAAgC,EAChC,mBAAmB,EACnB,wBAAwB,EACxB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,6BAA6B,EAC7B,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,0BAA0B,EAC1B,iCAAiC,EACjC,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,aAAa,EACb,mCAAmC,GACpC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,gCAAgC,EAChC,iCAAiC,EACjC,gCAAgC,EAChC,qBAAqB,EACrB,cAAc,EACd,kCAAkC,EAClC,mCAAmC,EACnC,kCAAkC,EAClC,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EACV,eAAe,EACf,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,SAAS,EACT,oBAAoB,EACpB,+BAA+B,EAC/B,4BAA4B,EAC5B,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,aAAa,EACb,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,YAAY,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,WAAW,EACX,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,sCAAsC,EACtC,4CAA4C,GAC7C,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/runtime/IAbapDebugger.d.ts

@@ -0,0 +1,150 @@
+import type { IAdtAnalyseOptions, IAnalyse } from '../adt/IAdtObject';
+import type { IAdtError, IAdtResponse } from '../adt/IAdtResponse';
+/**
+ * Who is debugging: the values SAP keys a user-mode listener and the
+ * breakpoints armed for it on. `terminalId` and `ideId` are 32 upper-case hex
+ * characters, chosen by the caller and kept for the whole session.
+ *
+ * A conflict between two listeners of one SAP user is decided by `ideId`: the
+ * same `ideId` never conflicts, another one either refuses the newcomer or is
+ * displaced by it, as the implementation is told to.
+ */
+export interface IDebuggerIdentity {
+    requestUser: string;
+    terminalId: string;
+    ideId: string;
+}
+interface IBreakpointCommon {
+    /** An ABAP condition; the breakpoint stops only where it holds. */
+    condition?: string;
+}
+/**
+ * The kinds of breakpoint. Only a line breakpoint is tied to an object; the
+ * others fire wherever the user's code reaches them, framework included.
+ *
+ * A message breakpoint names all three of id, number and type: one without the
+ * type makes SAP refuse the whole set.
+ */
+export type IDebuggerBreakpoint = (IBreakpointCommon & {
+    kind: 'line';
+    /** The source URI with `#start=<line>`. */
+    uri: string;
+}) | (IBreakpointCommon & {
+    kind: 'exception';
+    exceptionClass: string;
+}) | (IBreakpointCommon & {
+    kind: 'statement';
+    statement: string;
+}) | (IBreakpointCommon & {
+    kind: 'message';
+    msgId: string;
+    msgNo: string;
+    msgTy: string;
+});
+/** The steps that go from where the debuggee stands. */
+export type IDebuggerStepMethod = 'stepInto' | 'stepOver' | 'stepReturn' | 'stepContinue';
+/**
+ * The steps that go to a line, which they name. Without the line SAP answers
+ * 400 — and on one release (BASIS 758) let the program run to its end in the
+ * same moment, losing the stop, while BASIS 816 and SAP BTP ABAP Environment
+ * (2026-10-10) kept it suspended. The line is therefore an argument, not an option.
+ */
+export type IDebuggerStepToLineMethod = 'stepRunToLine' | 'stepJumpToLine';
+type WithAnalyse<E extends IAdtError, O = unknown> = O & IAdtAnalyseOptions<E> & {
+    analyse: IAnalyse<E>;
+};
+type WithoutAnalyse<O = unknown> = O & IAdtAnalyseOptions;
+/**
+ * The ABAP debugger in user mode, one member per request.
+ *
+ * **Two sessions, both stateful, both the caller's.** The listener holds one.
+ * Each debuggee caught is attached on another, opened for it; every member
+ * after {@link attach} addresses the debuggee through that one. On a system
+ * with more than one application server, an attach on the listener's session
+ * is refused whenever the debuggee runs elsewhere: the attach names the
+ * debuggee's server ({@link attach}'s `server`), and a session that has
+ * attached once cannot attach again.
+ *
+ * Every type parameter is what the implementation answers for that kind of
+ * request: the breakpoints set, the listener's catch, the attach, the stack,
+ * variables, a step, an answer with nothing to read, watchpoints, memory.
+ */
+export interface IAbapDebugger<TBreakpoints, TListener, TAttach, TStack, TVariables, TStep, TDone, TWatchpoints, TMemory> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'abapDebugger';
+    /** Arm breakpoints for the identity. Answers each one placed or refused. */
+    setBreakpoints<E extends IAdtError>(identity: IDebuggerIdentity, breakpoints: readonly IDebuggerBreakpoint[], options: WithAnalyse<E, {
+        validationOnly?: boolean;
+    }>): Promise<IAdtResponse<TBreakpoints, E>>;
+    setBreakpoints(identity: IDebuggerIdentity, breakpoints: readonly IDebuggerBreakpoint[], options?: WithoutAnalyse<{
+        validationOnly?: boolean;
+    }>): Promise<IAdtResponse<TBreakpoints>>;
+    deleteBreakpoint<E extends IAdtError>(identity: IDebuggerIdentity, breakpointId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TDone, E>>;
+    deleteBreakpoint(identity: IDebuggerIdentity, breakpointId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TDone>>;
+    /**
+     * Wait for a debuggee to stop at a breakpoint, up to `holdSeconds`. Nothing
+     * else may go out on this session while it waits.
+     */
+    listen<E extends IAdtError>(identity: IDebuggerIdentity, options: WithAnalyse<E, {
+        holdSeconds?: number;
+    }>): Promise<IAdtResponse<TListener, E>>;
+    listen(identity: IDebuggerIdentity, options?: WithoutAnalyse<{
+        holdSeconds?: number;
+    }>): Promise<IAdtResponse<TListener>>;
+    stopListener<E extends IAdtError>(identity: IDebuggerIdentity, options: WithAnalyse<E>): Promise<IAdtResponse<TDone, E>>;
+    stopListener(identity: IDebuggerIdentity, options?: WithoutAnalyse): Promise<IAdtResponse<TDone>>;
+    /** Take over a caught debuggee, on a session of its own. */
+    attach<E extends IAdtError>(requestUser: string, debuggeeId: string, options: WithAnalyse<E, IAttachOptions>): Promise<IAdtResponse<TAttach, E>>;
+    attach(requestUser: string, debuggeeId: string, options?: WithoutAnalyse<IAttachOptions>): Promise<IAdtResponse<TAttach>>;
+    getStack<E extends IAdtError>(options: WithAnalyse<E>): Promise<IAdtResponse<TStack, E>>;
+    getStack(options?: WithoutAnalyse): Promise<IAdtResponse<TStack>>;
+    /** The variables under each parent id: locals, globals, an object's attributes. */
+    getChildVariables<E extends IAdtError>(parentIds: readonly string[], options: WithAnalyse<E>): Promise<IAdtResponse<TVariables, E>>;
+    getChildVariables(parentIds: readonly string[], options?: WithoutAnalyse): Promise<IAdtResponse<TVariables>>;
+    getVariables<E extends IAdtError>(variableIds: readonly string[], options: WithAnalyse<E>): Promise<IAdtResponse<TVariables, E>>;
+    getVariables(variableIds: readonly string[], options?: WithoutAnalyse): Promise<IAdtResponse<TVariables>>;
+    step<E extends IAdtError>(method: IDebuggerStepMethod, options: WithAnalyse<E>): Promise<IAdtResponse<TStep, E>>;
+    step(method: IDebuggerStepMethod, options?: WithoutAnalyse): Promise<IAdtResponse<TStep>>;
+    /** Run to, or jump to, the line `uri` names (`#start=<line>`). */
+    stepToLine<E extends IAdtError>(method: IDebuggerStepToLineMethod, uri: string, options: WithAnalyse<E>): Promise<IAdtResponse<TStep, E>>;
+    stepToLine(method: IDebuggerStepToLineMethod, uri: string, options?: WithoutAnalyse): Promise<IAdtResponse<TStep>>;
+    /** Make a frame of the stack the one variables are read in. */
+    setStackPosition<E extends IAdtError>(position: number, options: WithAnalyse<E>): Promise<IAdtResponse<TDone, E>>;
+    setStackPosition(position: number, options?: WithoutAnalyse): Promise<IAdtResponse<TDone>>;
+    setVariableValue<E extends IAdtError>(variableName: string, value: string, options: WithAnalyse<E>): Promise<IAdtResponse<TVariables, E>>;
+    setVariableValue(variableName: string, value: string, options?: WithoutAnalyse): Promise<IAdtResponse<TVariables>>;
+    /** End the debuggee where it stands. */
+    terminateDebuggee<E extends IAdtError>(options: WithAnalyse<E>): Promise<IAdtResponse<TDone, E>>;
+    terminateDebuggee(options?: WithoutAnalyse): Promise<IAdtResponse<TDone>>;
+    createWatchpoint<E extends IAdtError>(variableName: string, options: WithAnalyse<E, {
+        condition?: string;
+    }>): Promise<IAdtResponse<TWatchpoints, E>>;
+    createWatchpoint(variableName: string, options?: WithoutAnalyse<{
+        condition?: string;
+    }>): Promise<IAdtResponse<TWatchpoints>>;
+    listWatchpoints<E extends IAdtError>(options: WithAnalyse<E>): Promise<IAdtResponse<TWatchpoints, E>>;
+    listWatchpoints(options?: WithoutAnalyse): Promise<IAdtResponse<TWatchpoints>>;
+    deleteWatchpoint<E extends IAdtError>(watchpointId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TDone, E>>;
+    deleteWatchpoint(watchpointId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TDone>>;
+    /** The debuggee's memory at the current stop. */
+    getMemorySizes<E extends IAdtError>(options: WithAnalyse<E, {
+        includeAbap?: boolean;
+    }>): Promise<IAdtResponse<TMemory, E>>;
+    getMemorySizes(options?: WithoutAnalyse<{
+        includeAbap?: boolean;
+    }>): Promise<IAdtResponse<TMemory>>;
+    /**
+     * Write a memory snapshot of the debuggee at the current stop. The answer
+     * names a file, not an id; the snapshot is read through
+     * {@link IMemorySnapshots} once it is listed there.
+     */
+    createMemorySnapshot<E extends IAdtError>(options: WithAnalyse<E>): Promise<IAdtResponse<TMemory, E>>;
+    createMemorySnapshot(options?: WithoutAnalyse): Promise<IAdtResponse<TMemory>>;
+}
+export interface IAttachOptions {
+    dynproDebugging?: boolean;
+    /** The debuggee's application server, as the listener's catch names it. */
+    server?: string;
+}
+export {};
+//# sourceMappingURL=IAbapDebugger.d.ts.map

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

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

package/dist/runtime/IAbapDebugger.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IAmdpDebugger.d.ts

@@ -0,0 +1,80 @@
+import type { IAdtAnalyseOptions, IAnalyse } from '../adt/IAdtObject';
+import type { IAdtError, IAdtResponse } from '../adt/IAdtResponse';
+export interface IStartAmdpDebuggerOptions {
+    /**
+     * End a debug session the user already has. One left behind by an
+     * interrupted run keeps the user locked out until it is ended.
+     */
+    stopExisting?: boolean;
+    /** Eclipse sends `NONE`. */
+    cascadeMode?: string;
+}
+/**
+ * An AMDP breakpoint: the AMDP class's source URI with `#start=<line>` of a
+ * SQLScript statement, and an id of the caller's choosing that the events
+ * name it by.
+ */
+export interface IAmdpBreakpoint {
+    uri: string;
+    clientId: string;
+}
+export type IAmdpStepMethod = 'over' | 'continue';
+/** Which table variable of a stopped debuggee to read, and how. */
+export interface IGetAmdpDataPreviewOptions {
+    /** The HANA session the debugger runs in, as `start` answered it. */
+    sessionId: string;
+    /** The debugger, as `start` answered it. */
+    debuggerId: string;
+    debuggeeId: string;
+    variableName: string;
+    rowNumber?: number;
+    provideRowId?: boolean;
+    /**
+     * A SELECT over the variable. Without one the server selects every column.
+     */
+    query?: string;
+}
+type WithAnalyse<E extends IAdtError, O = unknown> = O & IAdtAnalyseOptions<E> & {
+    analyse: IAnalyse<E>;
+};
+type WithoutAnalyse<O = unknown> = O & IAdtAnalyseOptions;
+/**
+ * The AMDP debugger, one member per request. A protocol of its own: nothing
+ * of it goes through the ABAP debugger.
+ *
+ * **Two sessions.** {@link start} and {@link getEvents} go on one stateful
+ * session; every command — breakpoints, steps, ending a debuggee, stopping —
+ * goes on another, and is answered with the request it became, not with its
+ * outcome. The outcome arrives as an event.
+ *
+ * **A stop never releases a suspended debuggee.** It is released by
+ * continuing it (to its end) or by deleting it (cancelling the execution).
+ */
+export interface IAmdpDebugger<TStarted, TEvents, TCommand, TPreview> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'amdpDebugger';
+    start<E extends IAdtError>(requestUser: string, options: WithAnalyse<E, IStartAmdpDebuggerOptions>): Promise<IAdtResponse<TStarted, E>>;
+    start(requestUser: string, options?: WithoutAnalyse<IStartAmdpDebuggerOptions>): Promise<IAdtResponse<TStarted>>;
+    /** Replace the breakpoints with these; none clears them. */
+    syncBreakpoints<E extends IAdtError>(mainId: string, breakpoints: readonly IAmdpBreakpoint[], options: WithAnalyse<E>): Promise<IAdtResponse<TCommand, E>>;
+    syncBreakpoints(mainId: string, breakpoints: readonly IAmdpBreakpoint[], options?: WithoutAnalyse): Promise<IAdtResponse<TCommand>>;
+    /** Wait for what happened next: a stop, a warning, an end. */
+    getEvents<E extends IAdtError>(mainId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TEvents, E>>;
+    getEvents(mainId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TEvents>>;
+    step<E extends IAdtError>(mainId: string, debuggeeId: string, step: IAmdpStepMethod, options: WithAnalyse<E>): Promise<IAdtResponse<TCommand, E>>;
+    step(mainId: string, debuggeeId: string, step: IAmdpStepMethod, options?: WithoutAnalyse): Promise<IAdtResponse<TCommand>>;
+    /** End a debuggee: its execution is cancelled. */
+    deleteDebuggee<E extends IAdtError>(mainId: string, debuggeeId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TCommand, E>>;
+    deleteDebuggee(mainId: string, debuggeeId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TCommand>>;
+    stop<E extends IAdtError>(mainId: string, options: WithAnalyse<E, {
+        hardStop?: boolean;
+    }>): Promise<IAdtResponse<TCommand, E>>;
+    stop(mainId: string, options?: WithoutAnalyse<{
+        hardStop?: boolean;
+    }>): Promise<IAdtResponse<TCommand>>;
+    /** A table variable's rows, answered at once, by column. */
+    getDataPreview<E extends IAdtError>(options: WithAnalyse<E, IGetAmdpDataPreviewOptions>): Promise<IAdtResponse<TPreview, E>>;
+    getDataPreview(options: WithoutAnalyse<IGetAmdpDataPreviewOptions>): Promise<IAdtResponse<TPreview>>;
+}
+export {};
+//# sourceMappingURL=IAmdpDebugger.d.ts.map

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

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

package/dist/runtime/IAmdpDebugger.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IMemorySnapshots.d.ts

@@ -0,0 +1,65 @@
+import type { IAdtAnalyseOptions, IAnalyse } from '../adt/IAdtObject';
+import type { IAdtError, IAdtResponse } from '../adt/IAdtResponse';
+export interface IMemorySnapshotsListOptions {
+    user?: string;
+    originalUser?: string;
+}
+/**
+ * The limits below are required: a view that takes one answers 400 without it.
+ */
+export interface ISnapshotRankingListOptions {
+    maxNumberOfObjects: number;
+    excludeAbapType?: string[];
+    sortAscending?: boolean;
+    sortByColumnName?: string;
+    groupByParentType?: boolean;
+}
+export interface ISnapshotChildrenOptions {
+    maxNumberOfObjects: number;
+    sortAscending?: boolean;
+    sortByColumnName?: string;
+}
+export interface ISnapshotReferencesOptions {
+    maxNumberOfReferences: number;
+}
+type WithAnalyse<E extends IAdtError, O = unknown> = O & IAdtAnalyseOptions<E> & {
+    analyse: IAnalyse<E>;
+};
+type WithoutAnalyse<O = unknown> = O & IAdtAnalyseOptions;
+/**
+ * The memory snapshots the system lists, one member per request.
+ *
+ * A snapshot is addressed by the id the list gives it, a memory object inside
+ * it by the `key` a ranking list gives it. A delta compares two snapshots: its
+ * values are those of `toId`, each with the change from `fromId`.
+ *
+ * A snapshot written by the debugger reaches the list only later. Reading it
+ * needs an authorization of its own; a user without it is answered an empty
+ * list, not a refusal.
+ */
+export interface IMemorySnapshots<TList, TSnapshot, TOverview, TRankingList, TChildren, TReferences> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'memorySnapshots';
+    list<E extends IAdtError>(options: WithAnalyse<E, IMemorySnapshotsListOptions>): Promise<IAdtResponse<TList, E>>;
+    list(options?: WithoutAnalyse<IMemorySnapshotsListOptions>): Promise<IAdtResponse<TList>>;
+    getById<E extends IAdtError>(snapshotId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TSnapshot, E>>;
+    getById(snapshotId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TSnapshot>>;
+    getOverview<E extends IAdtError>(snapshotId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TOverview, E>>;
+    getOverview(snapshotId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TOverview>>;
+    getRankingList<E extends IAdtError>(snapshotId: string, options: WithAnalyse<E, ISnapshotRankingListOptions>): Promise<IAdtResponse<TRankingList, E>>;
+    getRankingList(snapshotId: string, options: WithoutAnalyse<ISnapshotRankingListOptions>): Promise<IAdtResponse<TRankingList>>;
+    getChildren<E extends IAdtError>(snapshotId: string, parentKey: string, options: WithAnalyse<E, ISnapshotChildrenOptions>): Promise<IAdtResponse<TChildren, E>>;
+    getChildren(snapshotId: string, parentKey: string, options: WithoutAnalyse<ISnapshotChildrenOptions>): Promise<IAdtResponse<TChildren>>;
+    getReferences<E extends IAdtError>(snapshotId: string, objectKey: string, options: WithAnalyse<E, ISnapshotReferencesOptions>): Promise<IAdtResponse<TReferences, E>>;
+    getReferences(snapshotId: string, objectKey: string, options: WithoutAnalyse<ISnapshotReferencesOptions>): Promise<IAdtResponse<TReferences>>;
+    getDeltaOverview<E extends IAdtError>(fromId: string, toId: string, options: WithAnalyse<E>): Promise<IAdtResponse<TOverview, E>>;
+    getDeltaOverview(fromId: string, toId: string, options?: WithoutAnalyse): Promise<IAdtResponse<TOverview>>;
+    getDeltaRankingList<E extends IAdtError>(fromId: string, toId: string, options: WithAnalyse<E, ISnapshotRankingListOptions>): Promise<IAdtResponse<TRankingList, E>>;
+    getDeltaRankingList(fromId: string, toId: string, options: WithoutAnalyse<ISnapshotRankingListOptions>): Promise<IAdtResponse<TRankingList>>;
+    getDeltaChildren<E extends IAdtError>(fromId: string, toId: string, parentKey: string, options: WithAnalyse<E, ISnapshotChildrenOptions>): Promise<IAdtResponse<TChildren, E>>;
+    getDeltaChildren(fromId: string, toId: string, parentKey: string, options: WithoutAnalyse<ISnapshotChildrenOptions>): Promise<IAdtResponse<TChildren>>;
+    getDeltaReferences<E extends IAdtError>(fromId: string, toId: string, objectKey: string, options: WithAnalyse<E, ISnapshotReferencesOptions>): Promise<IAdtResponse<TReferences, E>>;
+    getDeltaReferences(fromId: string, toId: string, objectKey: string, options: WithoutAnalyse<ISnapshotReferencesOptions>): Promise<IAdtResponse<TReferences>>;
+}
+export {};
+//# sourceMappingURL=IMemorySnapshots.d.ts.map

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

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

package/dist/runtime/IMemorySnapshots.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/interfaces-adt",
-  "version": "13.0.0",
+  "version": "13.2.0",
   "description": "ADT contracts: object operations, runtime analysis, execution, feeds and service bindings",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",