@mcp-abap-adt/adt-clients 32.0.0 → 32.2.0

package/README.md

@@ -450,7 +450,7 @@ await utils.readObjectSource('view' satisfies AdtSourceObjectType, 'ZOK_I_CDS_TE
 The `withLongPolling` parameter asks ADT to hold a read until the object is
 available, instead of answering from whatever is there right now:
 
-> **Measured caveat — do not rely on it for readiness.** On an SAP BTP trial the
+> **Measured caveat — do not rely on it for readiness.** On the ABAP Cloud system the
 > parameter changes nothing on an object read. Reading a message class straight
 > after creating it returned `404` in ~650ms **with** the flag — the same
 > latency as without it — and the server did not hold the request. The system's
@@ -1115,3 +1115,31 @@ users can replace it with their own build.
 ## Author
 
 Oleksii Kyslytsia <oleksij.kyslytsja@gmail.com>
+
+### Recording batches
+
+`AdtBatchConnection` records calls from the existing clients. Start the member
+calls, execute the queue, then await their results. Group creates before locks,
+then queue writes with the returned lock handles before unlocks;
+activate all objects with one plain `activateObjectsGroup` call. At a debugger
+stop, record step + stack + variables on the attached stateful connection.
+See [domain and debugger examples](docs/usage/BATCH.md).
+
+`execute()` also sends follow-up envelopes for requests recorded during settlement,
+including automatic 406/415 negotiation retries (up to 100 envelopes, then all
+remaining requests reject). Explicit session switches apply to the next recording;
+LOCK/UNLOCK run in stateful envelopes; other ordinary members run stateless.
+Consecutive LOCKs, consecutive UNLOCKs, and consecutive stateless requests each
+form separate envelopes sent in queue order.
+Execution returns the last outer response. An envelope failure stops sending and
+rejects unsent requests with a clear library error; inner HTTP failures remain
+per-part failures. The wrapped session mode is restored after execution.
+
+```typescript
+import { AdtBatchConnection, AdtClient } from '@mcp-abap-adt/adt-clients';
+
+const batch = new AdtBatchConnection(connection, { endpoint: 'communication' });
+const pending = new AdtClient(batch).getDomain().readMetadata({ domainName: 'Z_DOMAIN' });
+await batch.execute();
+const answer = await pending;
+```

package/dist/batch/AdtBatchConnection.d.ts

@@ -0,0 +1,29 @@
+import type { IAbapConnection, IAbapRequestOptions, IAdtWireResponse } from '@mcp-abap-adt/interfaces-adt-connection';
+import type { ILogger } from '@mcp-abap-adt/interfaces-utils';
+type Session = 'stateful' | 'stateless';
+/** Records member requests; execute also drains requests queued during settlement. */
+export declare class AdtBatchConnection implements IAbapConnection {
+    private readonly connection;
+    private readonly options;
+    private queue;
+    private session;
+    private readonly defaultSession;
+    private settlementFailure?;
+    private executing;
+    constructor(connection: IAbapConnection, options: {
+        endpoint: 'communication' | 'debugger';
+        logger?: ILogger;
+    });
+    private wrappedSession;
+    connect(): Promise<void>;
+    getBaseUrl(): Promise<string>;
+    getSessionId(): string | null;
+    setSessionType(type: Session): void;
+    getSessionType(): Session;
+    makeAdtRequest<T = unknown, D = unknown>(request: IAbapRequestOptions): Promise<IAdtWireResponse<T, D>>;
+    private envelopeKey;
+    /** Empty queues return a synthetic 204, data '', without network traffic. */
+    execute(): Promise<IAdtWireResponse>;
+}
+export {};
+//# sourceMappingURL=AdtBatchConnection.d.ts.map

package/dist/batch/AdtBatchConnection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdtBatchConnection.d.ts","sourceRoot":"","sources":["../../src/batch/AdtBatchConnection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAI9D,KAAK,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAQxC,sFAAsF;AACtF,qBAAa,kBAAmB,YAAW,eAAe;IAOtD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,iBAAiB,CAAC,CAAqB;IAC/C,OAAO,CAAC,SAAS,CAAS;gBAEP,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE;QACxB,QAAQ,EAAE,eAAe,GAAG,UAAU,CAAC;QACvC,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB;IAQH,OAAO,CAAC,cAAc;IAWtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAGxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAG7B,YAAY,IAAI,MAAM,GAAG,IAAI;IAG7B,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAGnC,cAAc,IAAI,OAAO;IAGzB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,EACrC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAuBlC,OAAO,CAAC,WAAW;IAkBnB,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAuF3C"}

package/dist/batch/AdtBatchConnection.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdtBatchConnection = void 0;
+const objects_1 = require("../endpoints/objects");
+const wire_1 = require("./wire");
+/** Records member requests; execute also drains requests queued during settlement. */
+class AdtBatchConnection {
+    connection;
+    options;
+    queue = [];
+    session;
+    defaultSession;
+    settlementFailure;
+    executing = false;
+    constructor(connection, options) {
+        this.connection = connection;
+        this.options = options;
+        // Debugger requests use the attached stateful session; communication
+        // members opt into stateful mode only for their own LOCK or UNLOCK.
+        this.defaultSession =
+            options.endpoint === 'debugger' ? 'stateful' : 'stateless';
+        this.session = this.defaultSession;
+    }
+    wrappedSession() {
+        const connection = this.connection;
+        return (connection.getSessionType?.() ??
+            connection.getSessionMode?.() ??
+            'stateless');
+    }
+    connect() {
+        return this.connection.connect();
+    }
+    getBaseUrl() {
+        return this.connection.getBaseUrl();
+    }
+    getSessionId() {
+        return this.connection.getSessionId();
+    }
+    setSessionType(type) {
+        this.session = type;
+    }
+    getSessionType() {
+        return this.session;
+    }
+    makeAdtRequest(request) {
+        if (this.settlementFailure)
+            return Promise.reject(this.settlementFailure.error);
+        const headers = { ...request.headers };
+        const stateful = this.session === 'stateful' ||
+            Object.entries(headers).some(([key, value]) => key.toLowerCase() === 'x-sap-adt-sessiontype' && value === 'stateful');
+        // Members restore their mode only after the deferred answer. Scope an
+        // explicit switch to this recording so neighbouring members cannot inherit it.
+        this.session = this.defaultSession;
+        if (stateful)
+            headers['X-sap-adt-sessiontype'] = 'stateful';
+        return new Promise((resolve, reject) => {
+            this.queue.push({
+                request: { ...request, headers },
+                stateful,
+                resolve,
+                reject,
+            });
+        });
+    }
+    envelopeKey(part) {
+        if (!part.stateful)
+            return 'stateless';
+        if (this.options.endpoint === 'debugger')
+            return 'stateful';
+        const action = new URL(part.request.url, 'https://batch.invalid').searchParams.get('_action') ??
+            new URLSearchParams(part.request.params).get('_action');
+        if (action === 'LOCK')
+            return 'lock';
+        if (action === 'UNLOCK')
+            return 'unlock';
+        // Communication members currently use stateful mode only for LOCK/UNLOCK.
+        // Keep any future other stateful requests in their own consecutive group.
+        return 'stateful';
+    }
+    /** Empty queues return a synthetic 204, data '', without network traffic. */
+    async execute() {
+        if (this.executing)
+            throw new Error('An ADT batch execute is already in progress');
+        const pending = this.queue;
+        this.queue = [];
+        if (!pending.length)
+            return { status: 204, statusText: 'Empty batch', headers: {}, data: '' };
+        this.executing = true;
+        const previous = this.wrappedSession();
+        let active = [];
+        try {
+            let response;
+            for (let envelope = 0;; envelope++) {
+                if (envelope === 100)
+                    throw new Error('ADT batch exceeded 100 settlement envelopes');
+                const key = this.envelopeKey(pending[0]);
+                const nextMode = pending.findIndex((part) => this.envelopeKey(part) !== key);
+                active = pending.splice(0, nextMode < 0 ? pending.length : nextMode);
+                const payload = (0, wire_1.buildBatchPayload)(active.map((part) => (0, wire_1.innerRequest)(part.request)));
+                this.connection.setSessionType(active[0].stateful ? 'stateful' : 'stateless');
+                this.options.logger?.debug('Executing ADT batch', {
+                    endpoint: this.options.endpoint,
+                    parts: active.length,
+                });
+                response = await this.connection.makeAdtRequest({
+                    url: objects_1.BATCH[this.options.endpoint],
+                    method: 'POST',
+                    timeout: 0,
+                    data: payload.body,
+                    headers: {
+                        'Content-Type': `multipart/mixed; boundary=${payload.boundary}`,
+                        Accept: 'multipart/mixed',
+                    },
+                });
+                const parts = (0, wire_1.parseBatchResponse)(response);
+                for (const [index, part] of active.entries()) {
+                    const answer = parts[index];
+                    if (!answer)
+                        part.reject(new Error(`ADT batch response part count mismatch: expected ${active.length}, received ${parts.length}; missing part ${index + 1}`));
+                    else if (answer.status >= 200 && answer.status < 300)
+                        part.resolve(answer);
+                    else
+                        part.reject(Object.assign(new Error(`Request failed with status code ${answer.status}`), { response: answer }));
+                }
+                if (parts.length !== active.length)
+                    throw new Error(`ADT batch response part count mismatch: expected ${active.length}, received ${parts.length}`);
+                active = [];
+                // Let negotiation and member continuations record their follow-up calls.
+                await new Promise((resolve) => setImmediate(resolve));
+                pending.push(...this.queue.splice(0));
+                if (!pending.length)
+                    return response;
+            }
+        }
+        catch (error) {
+            const unsentError = new Error('ADT batch request not sent because an earlier batch envelope failed', { cause: error });
+            this.settlementFailure = { error: unsentError };
+            for (const part of active)
+                part.reject(error);
+            for (const part of pending)
+                part.reject(unsentError);
+            await new Promise((resolve) => setImmediate(resolve));
+            for (const part of this.queue.splice(0))
+                part.reject(unsentError);
+            await new Promise((resolve) => setImmediate(resolve));
+            throw error;
+        }
+        finally {
+            this.connection.setSessionType(previous);
+            this.executing = false;
+            this.settlementFailure = undefined;
+        }
+    }
+}
+exports.AdtBatchConnection = AdtBatchConnection;

package/dist/batch/index.d.ts

@@ -0,0 +1,2 @@
+export { AdtBatchConnection } from './AdtBatchConnection';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/batch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/batch/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdtBatchConnection = void 0;
+var AdtBatchConnection_1 = require("./AdtBatchConnection");
+Object.defineProperty(exports, "AdtBatchConnection", { enumerable: true, get: function () { return AdtBatchConnection_1.AdtBatchConnection; } });

package/dist/batch/wire.d.ts

@@ -0,0 +1,10 @@
+import type { IAbapRequestOptions, IAdtWireResponse } from '@mcp-abap-adt/interfaces-adt-connection';
+export declare const createBatchBoundary: () => string;
+export declare const createRequestId: () => string;
+export declare function buildBatchPayload(requests: readonly string[], boundary?: string): {
+    boundary: string;
+    body: string;
+};
+export declare function innerRequest(request: IAbapRequestOptions): string;
+export declare function parseBatchResponse(response: IAdtWireResponse): IAdtWireResponse[];
+//# sourceMappingURL=wire.d.ts.map

package/dist/batch/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/batch/wire.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,yCAAyC,CAAC;AAEjD,eAAO,MAAM,mBAAmB,QAAO,MAAiC,CAAC;AACzE,eAAO,MAAM,eAAe,QAAO,MAAwC,CAAC;AAE5E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,SAAwB,GAC/B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAWpC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqBjE;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,EAAE,CAyDpB"}

package/dist/batch/wire.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRequestId = exports.createBatchBoundary = void 0;
+exports.buildBatchPayload = buildBatchPayload;
+exports.innerRequest = innerRequest;
+exports.parseBatchResponse = parseBatchResponse;
+const node_crypto_1 = require("node:crypto");
+const createBatchBoundary = () => `batch_${(0, node_crypto_1.randomUUID)()}`;
+exports.createBatchBoundary = createBatchBoundary;
+const createRequestId = () => (0, node_crypto_1.randomUUID)().replace(/-/g, '');
+exports.createRequestId = createRequestId;
+function buildBatchPayload(requests, boundary = (0, exports.createBatchBoundary)()) {
+    return {
+        boundary,
+        body: requests
+            .map((request) => `--${boundary}\r\nContent-Type: application/http\r\ncontent-transfer-encoding: binary\r\n\r\n${request}`)
+            .join('') + `\r\n--${boundary}--\r\n`,
+    };
+}
+function innerRequest(request) {
+    const headers = { ...request.headers };
+    // `data: null` is how a member says "no body" (lock, unlock): it must not
+    // become the four characters "null". Sent that way, every PUT under those
+    // locks was refused 423 "invalid lock handle" (on an on-premise system, 2026-10-16).
+    const hasBody = request.data !== undefined && request.data !== null;
+    const body = hasBody ? String(request.data) : '';
+    if (hasBody) {
+        for (const key of Object.keys(headers))
+            if (key.toLowerCase() === 'content-length')
+                delete headers[key];
+        headers['Content-Length'] = String(Buffer.byteLength(body));
+    }
+    const params = request.params
+        ? new URLSearchParams(request.params).toString()
+        : '';
+    const url = request.url +
+        (params ? `${request.url.includes('?') ? '&' : '?'}${params}` : '');
+    return `${request.method} ${url} HTTP/1.1\r\n${Object.entries(headers)
+        .map(([key, value]) => `${key}: ${value}\r\n`)
+        .join('')}\r\n${body}\r\n`;
+}
+function parseBatchResponse(response) {
+    const contentType = Object.entries(response.headers).find(([key]) => key.toLowerCase() === 'content-type')?.[1];
+    const boundary = /boundary=(?:"([^"]+)"|([^;\s]+))/i.exec(String(contentType));
+    if (!boundary)
+        throw new Error('Invalid ADT batch response: missing multipart boundary');
+    const escaped = (boundary[1] ?? boundary[2]).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Only complete delimiter lines count; boundary-like body text is payload.
+    const delimiter = new RegExp(`(?:^|\\r?\\n)--${escaped}(--)?[ \t]*(?:\\r?\\n|$)`, 'g');
+    const body = String(response.data);
+    const chunks = [];
+    let start;
+    for (const match of body.matchAll(delimiter)) {
+        if (start !== undefined)
+            chunks.push(body.slice(start, match.index));
+        if (match[1])
+            break;
+        start = match.index + match[0].length;
+    }
+    return chunks.map((part) => {
+        const match = /(?:^|\r?\n)HTTP\/1\.\d\s+(\d{3})\s*([^\r\n]*)\r?\n/.exec(part);
+        if (!match || match.index === undefined)
+            throw new Error('Invalid ADT batch response: missing inner HTTP status');
+        const rest = part.slice(match.index + match[0].length);
+        // A bodyless answer (an UNLOCK's 200) ends right after its headers: the
+        // empty line's last CRLF belongs to the next delimiter (RFC 2046), so the
+        // part holds one line break, not two. Headers then run to the end.
+        // Immediately after the status line, one blank line means no headers.
+        const found = /^(?:\r?\n)|\r?\n\r?\n/.exec(rest);
+        const split = found && found.index !== undefined
+            ? { index: found.index, length: found[0].length }
+            : { index: rest.length, length: 0 };
+        const headers = {};
+        for (const line of rest.slice(0, split.index).split(/\r?\n/)) {
+            const colon = line.indexOf(':');
+            if (colon > 0)
+                headers[line.slice(0, colon).toLowerCase()] = line
+                    .slice(colon + 1)
+                    .trim();
+        }
+        return {
+            status: Number(match[1]),
+            statusText: match[2].trim(),
+            headers,
+            data: rest.slice(split.index + split.length),
+        };
+    });
+}

package/dist/core/accessControl/versions.d.ts

@@ -7,7 +7,7 @@ import type { IAccessControlConfig } from './types';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 export declare function getAccessControlVersions(connection: IAbapConnection, config: Partial<IAccessControlConfig>): Promise<IAdtWireResponse>;
 /** The source of one version, by the `contentUri` its entry carried. */

package/dist/core/accessControl/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 async function getAccessControlVersions(connection, config) {
     return connection.makeAdtRequest({

package/dist/core/appendStructure/versions.d.ts

@@ -7,7 +7,7 @@ import type { IAppendStructureConfig } from './types';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 export declare function getAppendStructureVersions(connection: IAbapConnection, config: Partial<IAppendStructureConfig>): Promise<IAdtWireResponse>;
 /** The source of one version, by the `contentUri` its entry carried. */

package/dist/core/appendStructure/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 async function getAppendStructureVersions(connection, config) {
     return connection.makeAdtRequest({

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

@@ -7,7 +7,7 @@ import type { IBehaviorDefinitionConfig } from './types';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 export declare function getBehaviorDefinitionVersions(connection: IAbapConnection, config: Partial<IBehaviorDefinitionConfig>): Promise<IAdtWireResponse>;
 /** The source of one version, by the `contentUri` its entry carried. */

package/dist/core/behaviorDefinition/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 async function getBehaviorDefinitionVersions(connection, config) {
     return connection.makeAdtRequest({

package/dist/core/behaviorImplementation/versions.d.ts

@@ -7,7 +7,7 @@ import type { IBehaviorImplementationConfig } from './types';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 export declare function getBehaviorImplementationVersions(connection: IAbapConnection, config: Partial<IBehaviorImplementationConfig>): Promise<IAdtWireResponse>;
 /** The source of one version, by the `contentUri` its entry carried. */

package/dist/core/behaviorImplementation/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  *
- * Candidate URI — probe-verify on trial.
+ * Candidate URI — probe-verify on the ABAP Cloud system.
  */
 async function getBehaviorImplementationVersions(connection, config) {
     return connection.makeAdtRequest({

package/dist/core/enhancement/versions.js

@@ -12,7 +12,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  */
-// candidate URI — probe-verify on trial
+// candidate URI — probe-verify on the ABAP Cloud system
 async function getEnhancementVersions(connection, config) {
     return connection.makeAdtRequest({
         url: `${(0, types_1.getEnhancementUri)(config.enhancementType, config.enhancementName)}/source/main/versions`,

package/dist/core/functionGroup/create.js

@@ -20,7 +20,7 @@ async function create(connection, params, logger, contentTypes) {
     if (finalResponsible && finalResponsible.trim() === '') {
         finalResponsible = undefined;
     }
-    // Don't escape masterSystem and responsible - they are identifiers (like "TRL", "CB9980002377")
+    // Don't escape masterSystem and responsible - they are identifiers (like "SID", "DEVELOPER")
     // Escaping them may cause SAP to fail parsing and trigger Kerberos errors
     const masterSystemAttr = finalMasterSystem
         ? ` adtcore:masterSystem="${finalMasterSystem}"`

package/dist/core/functionInclude/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  */
-// candidate URI — probe-verify on trial
+// candidate URI — probe-verify on the ABAP Cloud system
 async function getFunctionIncludeVersions(connection, config) {
     return connection.makeAdtRequest({
         url: `${(0, objects_1.versionsUri)((0, objects_1.sourceUri)(objects_1.FUNCTION_INCLUDE.uri(config.functionGroupName, config.includeName.toUpperCase())))}`,

package/dist/core/functionModule/versions.js

@@ -11,7 +11,7 @@ const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
  * system without the resource answers 404 or 406, which comes back as the
  * transport's failure; until 23.0.0 it was thrown as a library error.
  */
-// candidate URI — probe-verify on trial
+// candidate URI — probe-verify on the ABAP Cloud system
 async function getFunctionModuleVersions(connection, config) {
     return connection.makeAdtRequest({
         url: `${(0, objects_1.versionsUri)((0, objects_1.sourceUri)(objects_1.FUNCTION_MODULE.uri(config.functionGroupName, config.functionModuleName)))}`,

package/dist/core/scalarFunction/versions.d.ts

@@ -2,7 +2,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
 import type { IScalarFunctionConfig } from './types';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/scalarFunction/versions.js

@@ -6,7 +6,7 @@ const objects_1 = require("../../endpoints/objects");
 const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/scalarFunctionImplementation/versions.d.ts

@@ -2,7 +2,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
 import type { IScalarFunctionImplementationConfig } from './types';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/scalarFunctionImplementation/versions.js

@@ -6,7 +6,7 @@ const objects_1 = require("../../endpoints/objects");
 const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/service/AdtService.js

@@ -74,7 +74,7 @@ class AdtServiceBinding {
     }
     async publishByServiceType(serviceType, bindingName, 
     // **The caller's, when they give one — else none.** A publication job is
-    // the slowest thing this library asks for — measured at ~135s on a trial,
+    // the slowest thing this library asks for — measured at ~135s on the ABAP Cloud system,
     // and an unpublish once not settled after eleven minutes. The library sets
     // no deadline of its own; `IAdtOperationOptions.timeout` is how a caller
     // asks for one.
@@ -125,7 +125,7 @@ class AdtServiceBinding {
     }
     async unpublishByServiceType(serviceType, bindingName, 
     // **The caller's, when they give one — else none.** A publication job is
-    // the slowest thing this library asks for — measured at ~135s on a trial,
+    // the slowest thing this library asks for — measured at ~135s on the ABAP Cloud system,
     // and an unpublish once not settled after eleven minutes. The library sets
     // no deadline of its own; `IAdtOperationOptions.timeout` is how a caller
     // asks for one.

package/dist/core/service/lock.d.ts

@@ -2,7 +2,7 @@
  * Locking a service binding — which is what publishing one is.
  *
  * A binding is not edited the way a class is: it is created, and then published
- * and unpublished. Measured from Eclipse (ADT 3.60.3) on the BTP trial,
+ * and unpublished. Measured from Eclipse (ADT 3.60.3) on the ABAP Cloud system,
  * 2026-09-05, the lock is what those two take:
  *
  * ```

package/dist/core/service/lock.js

@@ -3,7 +3,7 @@
  * Locking a service binding — which is what publishing one is.
  *
  * A binding is not edited the way a class is: it is created, and then published
- * and unpublished. Measured from Eclipse (ADT 3.60.3) on the BTP trial,
+ * and unpublished. Measured from Eclipse (ADT 3.60.3) on the ABAP Cloud system,
  * 2026-09-05, the lock is what those two take:
  *
  * ```

package/dist/core/service/types.d.ts

@@ -105,7 +105,7 @@ export type IServiceBindingPublicationConfig = Partial<ISBC> & {
 /**
  * What a publication job needs, which is not the same for the two protocols.
  *
- * **V2 requires the service name and version; V4 does not.** Measured on a trial,
+ * **V2 requires the service name and version; V4 does not.** Measured on an ABAP Cloud system,
  * 2026-09-29, on one binding per protocol with a known publication state and a
  * single job each — the only difference being the query string:
  *
@@ -141,7 +141,7 @@ interface IServiceBindingPublicationCommon {
      * How long to wait for the publication job, in milliseconds.
      *
      * A publication is the slowest request this library makes — ~135s measured on
-     * a trial, and one unpublish still unsettled after eleven minutes. Absent, the
+     * the ABAP Cloud system, and one unpublish still unsettled after eleven minutes. Absent, the
      * request carries no deadline: it waits for SAP's answer.
      */
     timeout?: number;

package/dist/core/serviceDefinition/versions.d.ts

@@ -2,7 +2,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
 import type { IServiceDefinitionConfig } from './types';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/serviceDefinition/versions.js

@@ -6,7 +6,7 @@ const objects_1 = require("../../endpoints/objects");
 const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/structure/versions.d.ts

@@ -2,7 +2,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
 import type { IStructureConfig } from './types';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/structure/versions.js

@@ -6,7 +6,7 @@ const objects_1 = require("../../endpoints/objects");
 const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/tabletype/versions.d.ts

@@ -2,7 +2,7 @@ import type { IAbapConnection, IAdtWireResponse } from '@mcp-abap-adt/interfaces
 import type { ITableTypeConfig } from './types';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the

package/dist/core/tabletype/versions.js

@@ -6,7 +6,7 @@ const objects_1 = require("../../endpoints/objects");
 const ACCEPT_VERSION_FEED = 'application/atom+xml;type=feed';
 /**
  * The version history — the Atom feed, as it arrived (candidate URI,
- * probe-verify on trial).
+ * probe-verify on the ABAP Cloud system).
  *
  * `objectVersions` in @mcp-abap-adt/adt-strategies reads it into entries. A
  * system without the resource answers 404 or 406, which comes back as the