@mcp-abap-adt/llm-agent-mcp 20.4.0 → 20.6.0

package/dist/auxiliary/cancelable-delay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A `setTimeout`-based delay that REJECTS on `signal` abort (before or during),
+ * clearing its timer on settle/abort. It does NOT swallow abort — the rejection
+ * must propagate so the controller's per-step abort discriminator handles it.
+ */
+export declare function cancelableDelay(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=cancelable-delay.d.ts.map

package/dist/auxiliary/cancelable-delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelable-delay.d.ts","sourceRoot":"","sources":["../../src/auxiliary/cancelable-delay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/auxiliary/cancelable-delay.js

@@ -0,0 +1,25 @@
+/**
+ * A `setTimeout`-based delay that REJECTS on `signal` abort (before or during),
+ * clearing its timer on settle/abort. It does NOT swallow abort — the rejection
+ * must propagate so the controller's per-step abort discriminator handles it.
+ */
+export function cancelableDelay(ms, signal) {
+    return new Promise((resolve, reject) => {
+        const abortError = () => signal?.reason ??
+            new DOMException('Aborted', 'AbortError');
+        if (signal?.aborted) {
+            reject(abortError());
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(abortError());
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=cancelable-delay.js.map

package/dist/auxiliary/cancelable-delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancelable-delay.js","sourceRoot":"","sources":["../../src/auxiliary/cancelable-delay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAU,EACV,MAAoB;IAEpB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,UAAU,GAAG,GAAU,EAAE,CAC5B,MAAM,EAAE,MAA4B;YACrC,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAE5C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/auxiliary/default-auxiliary-mcp-tools.d.ts

@@ -0,0 +1,16 @@
+import type { CallOptions, IAuxiliaryMcpTools, McpError as McpErrorType, McpTool, McpToolResult, Result } from '@mcp-abap-adt/llm-agent';
+import type { AuxToolEntry } from './wait-tool.js';
+/**
+ * Our example `IAuxiliaryMcpTools`: a fixed list of in-process tool entries.
+ * `listTools` returns their defs; `callTool` routes by name to the handler.
+ * An unknown name is a tool-level error (NOT thrown — never "unavailable").
+ * A handler that REJECTS (e.g. `wait` on abort) propagates unchanged.
+ */
+export declare class DefaultAuxiliaryMcpTools implements IAuxiliaryMcpTools {
+    private readonly entries;
+    private readonly byName;
+    constructor(entries: AuxToolEntry[]);
+    listTools(): Promise<Result<McpTool[], McpErrorType>>;
+    callTool(name: string, args: Record<string, unknown>, options?: CallOptions): Promise<Result<McpToolResult, McpErrorType>>;
+}
+//# sourceMappingURL=default-auxiliary-mcp-tools.d.ts.map

package/dist/auxiliary/default-auxiliary-mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-auxiliary-mcp-tools.d.ts","sourceRoot":"","sources":["../../src/auxiliary/default-auxiliary-mcp-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,kBAAkB,EAClB,QAAQ,IAAI,YAAY,EACxB,OAAO,EACP,aAAa,EACb,MAAM,EACP,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;;;;GAKG;AACH,qBAAa,wBAAyB,YAAW,kBAAkB;IAGrD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEtB,OAAO,EAAE,YAAY,EAAE;IAI9C,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;IAIrD,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;CAUhD"}

package/dist/auxiliary/default-auxiliary-mcp-tools.js

@@ -0,0 +1,29 @@
+import { McpError } from '@mcp-abap-adt/llm-agent';
+/**
+ * Our example `IAuxiliaryMcpTools`: a fixed list of in-process tool entries.
+ * `listTools` returns their defs; `callTool` routes by name to the handler.
+ * An unknown name is a tool-level error (NOT thrown — never "unavailable").
+ * A handler that REJECTS (e.g. `wait` on abort) propagates unchanged.
+ */
+export class DefaultAuxiliaryMcpTools {
+    entries;
+    byName;
+    constructor(entries) {
+        this.entries = entries;
+        this.byName = new Map(entries.map((e) => [e.def.name, e]));
+    }
+    async listTools() {
+        return { ok: true, value: this.entries.map((e) => e.def) };
+    }
+    async callTool(name, args, options) {
+        const entry = this.byName.get(name);
+        if (!entry) {
+            return {
+                ok: false,
+                error: new McpError(`unknown auxiliary tool: ${name}`),
+            };
+        }
+        return entry.handler(args, options);
+    }
+}
+//# sourceMappingURL=default-auxiliary-mcp-tools.js.map

package/dist/auxiliary/default-auxiliary-mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-auxiliary-mcp-tools.js","sourceRoot":"","sources":["../../src/auxiliary/default-auxiliary-mcp-tools.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGnD;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAGN;IAFZ,MAAM,CAA4B;IAEnD,YAA6B,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,SAAS;QACb,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,IAA6B,EAC7B,OAAqB;QAErB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,2BAA2B,IAAI,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/auxiliary/wait-tool.d.ts

@@ -0,0 +1,14 @@
+import type { CallOptions, McpError as McpErrorType, McpTool, McpToolResult, Result } from '@mcp-abap-adt/llm-agent';
+export interface AuxToolEntry {
+    def: McpTool;
+    handler: (args: Record<string, unknown>, options?: CallOptions) => Promise<Result<McpToolResult, McpErrorType>>;
+}
+export declare const DEFAULT_WAIT_MAX_SECONDS = 60;
+/**
+ * The `wait` auxiliary tool: pause N seconds (clamped to `maxSeconds`) before
+ * continuing. Honors `options.signal` via `cancelableDelay` — an abort
+ * propagates (rejects). Invalid `seconds` is a tool-level error (returned,
+ * not thrown).
+ */
+export declare function makeWaitTool(maxSeconds?: number): AuxToolEntry;
+//# sourceMappingURL=wait-tool.d.ts.map

package/dist/auxiliary/wait-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-tool.d.ts","sourceRoot":"","sources":["../../src/auxiliary/wait-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,IAAI,YAAY,EACxB,OAAO,EACP,aAAa,EACb,MAAM,EACP,MAAM,yBAAyB,CAAC;AAIjC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,UAAU,GAAE,MAAiC,GAC5C,YAAY,CA8Bd"}

package/dist/auxiliary/wait-tool.js

@@ -0,0 +1,39 @@
+import { McpError } from '@mcp-abap-adt/llm-agent';
+import { cancelableDelay } from './cancelable-delay.js';
+export const DEFAULT_WAIT_MAX_SECONDS = 60;
+/**
+ * The `wait` auxiliary tool: pause N seconds (clamped to `maxSeconds`) before
+ * continuing. Honors `options.signal` via `cancelableDelay` — an abort
+ * propagates (rejects). Invalid `seconds` is a tool-level error (returned,
+ * not thrown).
+ */
+export function makeWaitTool(maxSeconds = DEFAULT_WAIT_MAX_SECONDS) {
+    return {
+        def: {
+            name: 'wait',
+            description: 'Pause for the given number of seconds before continuing. Use after ' +
+                'an asynchronous create/activate operation, before verifying, to let ' +
+                `the system settle. Maximum ${maxSeconds} seconds.`,
+            inputSchema: {
+                type: 'object',
+                properties: { seconds: { type: 'number', minimum: 0 } },
+                required: ['seconds'],
+                additionalProperties: false,
+            },
+        },
+        handler: async (args, options) => {
+            const raw = args.seconds;
+            if (typeof raw !== 'number' || !Number.isFinite(raw) || raw < 0) {
+                return {
+                    ok: false,
+                    error: new McpError("wait: 'seconds' must be a non-negative number"),
+                };
+            }
+            const clamped = Math.min(raw, maxSeconds);
+            await cancelableDelay(clamped * 1000, options?.signal);
+            const note = clamped < raw ? ` (requested ${raw}, capped at ${maxSeconds})` : '';
+            return { ok: true, value: { content: `Waited ${clamped}s${note}` } };
+        },
+    };
+}
+//# sourceMappingURL=wait-tool.js.map

package/dist/auxiliary/wait-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-tool.js","sourceRoot":"","sources":["../../src/auxiliary/wait-tool.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAUxD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,aAAqB,wBAAwB;IAE7C,OAAO;QACL,GAAG,EAAE;YACH,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,qEAAqE;gBACrE,sEAAsE;gBACtE,8BAA8B,UAAU,WAAW;YACrD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;gBACvD,QAAQ,EAAE,CAAC,SAAS,CAAC;gBACrB,oBAAoB,EAAE,KAAK;aAC5B;SACF;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC/B,MAAM,GAAG,GAAI,IAA8B,CAAC,OAAO,CAAC;YACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;gBAChE,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,IAAI,QAAQ,CAAC,+CAA+C,CAAC;iBACrE,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAC1C,MAAM,eAAe,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,IAAI,GACR,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,eAAe,GAAG,eAAe,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,UAAU,OAAO,IAAI,IAAI,EAAE,EAAE,EAAE,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,8 @@
 export { McpClientAdapter } from './adapter.js';
+export { cancelableDelay } from './auxiliary/cancelable-delay.js';
+export { DefaultAuxiliaryMcpTools } from './auxiliary/default-auxiliary-mcp-tools.js';
+export type { AuxToolEntry } from './auxiliary/wait-tool.js';
+export { DEFAULT_WAIT_MAX_SECONDS, makeWaitTool, } from './auxiliary/wait-tool.js';
 export { type MCPClientConfig, MCPClientWrapper, type TransportType, } from './client.js';
 export { DefaultMcpFailureClassifier } from './default-mcp-failure-classifier.js';
 export { createDefaultMcpClient } from './factory.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,eAAe,EACpB,gBAAgB,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,4 +1,7 @@
 export { McpClientAdapter } from './adapter.js';
+export { cancelableDelay } from './auxiliary/cancelable-delay.js';
+export { DefaultAuxiliaryMcpTools } from './auxiliary/default-auxiliary-mcp-tools.js';
+export { DEFAULT_WAIT_MAX_SECONDS, makeWaitTool, } from './auxiliary/wait-tool.js';
 export { MCPClientWrapper, } from './client.js';
 export { DefaultMcpFailureClassifier } from './default-mcp-failure-classifier.js';
 export { createDefaultMcpClient } from './factory.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACL,sBAAsB,EAEtB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAEtF,OAAO,EACL,wBAAwB,EACxB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,gBAAgB,GAEjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EACL,sBAAsB,EAEtB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-abap-adt/llm-agent-mcp",
-  "version": "20.4.0",
+  "version": "20.6.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -21,7 +21,7 @@
     "test": "node --import tsx/esm --test --test-reporter=spec 'src/**/*.test.ts'"
   },
   "dependencies": {
-    "@mcp-abap-adt/llm-agent": "^20.4.0",
+    "@mcp-abap-adt/llm-agent": "^20.6.0",
     "@modelcontextprotocol/sdk": "^1.28.0"
   },
   "publishConfig": {