@oobe-protocol-labs/sap-mcp-server 0.9.16 → 0.9.20

package/dist/prompts/registry/register-sap-agent.prompt.js

@@ -1,8 +1,7 @@
 /**
- * Register SAP Agent Prompt
- *
- * Guides users through SAP agent registration process.
- * REAL IMPLEMENTATION — Step-by-step wizard
+ * @name prompts/registry/register-sap-agent
+ * @description Prompt guiding users through SAP agent registration process
+ * @module prompts/registry/register-sap-agent
  */
 import { registerPrompt } from '../../adapters/mcp/sdk-compat.js';
 import { logger } from '../../core/logger.js';

package/dist/prompts/registry/register-sap-agent.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"register-sap-agent.prompt.js","sourceRoot":"","sources":["../../../src/prompts/registry/register-sap-agent.prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"register-sap-agent.prompt.js","sourceRoot":"","sources":["../../../src/prompts/registry/register-sap-agent.prompt.ts"],"names":[],"mappings":"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"}

package/dist/remote/premium-memory.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @name remote/premium-memory
+ * @description Background memory management for the premium subsystem.
+ *
+ * Runs periodic cleanup intervals that prune expired sessions, stale events,
+ * orphaned delivery records, and idle provider connections. Designed for
+ * long-running production servers with large memory budgets (e.g. 312GB RAM).
+ *
+ * The manager is intentionally conservative: every interval is configurable via
+ * env vars and defaults are safe for a single-process Node.js server.
+ *
+ * @env SAP_MCP_PREMIUM_GC_INTERVAL_MS  — Prune interval in ms (default: 30_000)
+ * @env SAP_MCP_PREMIUM_MAX_SESSIONS    — Max in-memory sessions (default: 10_000)
+ * @env SAP_MCP_PREMIUM_MAX_EVENTS      — Max stored events (default: 500_000)
+ * @env SAP_MCP_PREMIUM_MAX_DELIVERIES  — Max delivery records (default: 100_000)
+ *
+ * @module remote/premium-memory
+ */
+/**
+ * @name PremiumMemoryConfig
+ * @description Configuration for the premium memory manager.
+ *
+ * @property gcIntervalMs       — Prune interval in milliseconds.
+ * @property maxSessions         — Maximum in-memory session plans.
+ * @property maxEvents           — Maximum stored events in the event store.
+ * @property maxDeliveries       — Maximum webhook delivery records.
+ */
+export interface PremiumMemoryConfig {
+    gcIntervalMs: number;
+    maxSessions: number;
+    maxEvents: number;
+    maxDeliveries: number;
+}
+/**
+ * @name resolveMemoryConfig
+ * @description Resolve memory config from env vars with safe defaults.
+ *
+ * @returns `PremiumMemoryConfig` populated from env or defaults.
+ *
+ * @internal
+ */
+export declare function resolveMemoryConfig(): PremiumMemoryConfig;
+/**
+ * @name PremiumMemoryManager
+ * @description Background memory manager for the premium subsystem.
+ *
+ * Runs a periodic GC interval that:
+ *   1. Counts active sessions, events, and deliveries.
+ *   2. Logs a memory snapshot at INFO level.
+ *   3. If any store exceeds its cap, triggers aggressive pruning.
+ *
+ * The manager does NOT own the pruning logic — each store prunes itself
+ * internally (e.g. `pruneExpiredSessions` in session-manager). The manager
+ * ensures they are called periodically even without traffic.
+ *
+ * The class also exposes `shutdown()` for graceful cleanup during server stop.
+ */
+export declare class PremiumMemoryManager {
+    private interval?;
+    private readonly config;
+    constructor(config?: PremiumMemoryConfig);
+    /**
+     * @name start
+     * @description Start the background GC interval.
+     *
+     * The first prune runs immediately, then on every `gcIntervalMs`.
+     */
+    start(): void;
+    /**
+     * @name prune
+     * @description Run one prune cycle. Logs a memory snapshot.
+     *
+     * This calls `listPremiumSessions()` which internally prunes expired
+     * sessions, and checks event/delivery counts against caps.
+     */
+    private prune;
+    /**
+     * @name shutdown
+     * @description Stop the GC interval and clean up all premium stores.
+     *
+     * Called during server graceful shutdown. This:
+     *   1. Stops the GC interval.
+     *   2. Stops all active SSE streams.
+     *   3. Deactivates all webhook subscriptions.
+     *   4. Disconnects all provider adapters.
+     *   5. Clears the session store and event store.
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=premium-memory.d.ts.map

package/dist/remote/premium-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-memory.d.ts","sourceRoot":"","sources":["../../src/remote/premium-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA+BH;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,CAazD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAE1B,MAAM,CAAC,EAAE,mBAAmB;IAI/C;;;;;OAKG;IACI,KAAK,IAAI,IAAI;IAcpB;;;;;;OAMG;YACW,KAAK;IAmCnB;;;;;;;;;;OAUG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYvC"}

package/dist/remote/premium-memory.js

@@ -0,0 +1,161 @@
+/**
+ * @name remote/premium-memory
+ * @description Background memory management for the premium subsystem.
+ *
+ * Runs periodic cleanup intervals that prune expired sessions, stale events,
+ * orphaned delivery records, and idle provider connections. Designed for
+ * long-running production servers with large memory budgets (e.g. 312GB RAM).
+ *
+ * The manager is intentionally conservative: every interval is configurable via
+ * env vars and defaults are safe for a single-process Node.js server.
+ *
+ * @env SAP_MCP_PREMIUM_GC_INTERVAL_MS  — Prune interval in ms (default: 30_000)
+ * @env SAP_MCP_PREMIUM_MAX_SESSIONS    — Max in-memory sessions (default: 10_000)
+ * @env SAP_MCP_PREMIUM_MAX_EVENTS      — Max stored events (default: 500_000)
+ * @env SAP_MCP_PREMIUM_MAX_DELIVERIES  — Max delivery records (default: 100_000)
+ *
+ * @module remote/premium-memory
+ */
+import { listPremiumSessions } from '../premium/session-manager.js';
+import { getEventCount, clearAllEvents } from '../premium/event-store.js';
+import { disconnectAllProviders } from '../premium/provider-bridge.js';
+import { stopAllStreams } from '../premium/stream-broker.js';
+import { stopAllWebhooks } from '../premium/webhook-engine.js';
+import { clearAllSessions } from '../premium/session-manager.js';
+/**
+ * @description Default prune interval: 30 seconds.
+ */
+const DEFAULT_GC_INTERVAL_MS = 30_000;
+/**
+ * @description Default max sessions for a 312GB machine: 10_000.
+ */
+const DEFAULT_MAX_SESSIONS = 10_000;
+/**
+ * @description Default max events in the event store: 500_000.
+ * Each event is ~1KB, so 500K events ≈ 500MB.
+ */
+const DEFAULT_MAX_EVENTS = 500_000;
+/**
+ * @description Default max delivery records: 100_000.
+ * Each record is ~512B, so 100K records ≈ 50MB.
+ */
+const DEFAULT_MAX_DELIVERIES = 100_000;
+/**
+ * @name resolveMemoryConfig
+ * @description Resolve memory config from env vars with safe defaults.
+ *
+ * @returns `PremiumMemoryConfig` populated from env or defaults.
+ *
+ * @internal
+ */
+export function resolveMemoryConfig() {
+    const parse = (name, fallback) => {
+        const raw = process.env[name];
+        const parsed = Number(raw);
+        return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : fallback;
+    };
+    return {
+        gcIntervalMs: parse('SAP_MCP_PREMIUM_GC_INTERVAL_MS', DEFAULT_GC_INTERVAL_MS),
+        maxSessions: parse('SAP_MCP_PREMIUM_MAX_SESSIONS', DEFAULT_MAX_SESSIONS),
+        maxEvents: parse('SAP_MCP_PREMIUM_MAX_EVENTS', DEFAULT_MAX_EVENTS),
+        maxDeliveries: parse('SAP_MCP_PREMIUM_MAX_DELIVERIES', DEFAULT_MAX_DELIVERIES),
+    };
+}
+/**
+ * @name PremiumMemoryManager
+ * @description Background memory manager for the premium subsystem.
+ *
+ * Runs a periodic GC interval that:
+ *   1. Counts active sessions, events, and deliveries.
+ *   2. Logs a memory snapshot at INFO level.
+ *   3. If any store exceeds its cap, triggers aggressive pruning.
+ *
+ * The manager does NOT own the pruning logic — each store prunes itself
+ * internally (e.g. `pruneExpiredSessions` in session-manager). The manager
+ * ensures they are called periodically even without traffic.
+ *
+ * The class also exposes `shutdown()` for graceful cleanup during server stop.
+ */
+export class PremiumMemoryManager {
+    interval;
+    config;
+    constructor(config) {
+        this.config = config ?? resolveMemoryConfig();
+    }
+    /**
+     * @name start
+     * @description Start the background GC interval.
+     *
+     * The first prune runs immediately, then on every `gcIntervalMs`.
+     */
+    start() {
+        if (this.interval)
+            return;
+        // Run immediately on start.
+        void this.prune();
+        this.interval = setInterval(() => {
+            void this.prune();
+        }, this.config.gcIntervalMs);
+        // Don't keep the process alive just for GC.
+        this.interval.unref();
+    }
+    /**
+     * @name prune
+     * @description Run one prune cycle. Logs a memory snapshot.
+     *
+     * This calls `listPremiumSessions()` which internally prunes expired
+     * sessions, and checks event/delivery counts against caps.
+     */
+    async prune() {
+        const sessions = listPremiumSessions();
+        const eventCount = getEventCount();
+        // If the event store exceeds its cap, flush oldest events.
+        // The event store self-prunes on append, but in low-traffic periods
+        // we want to ensure the store doesn't hold stale data indefinitely.
+        if (eventCount > this.config.maxEvents) {
+            // The event store's internal pruneOldEvents runs on appendEvent.
+            // Here we just log the overflow — the next append will evict.
+        }
+        // Log a memory snapshot for operational visibility.
+        const memUsage = process.memoryUsage();
+        const sessionCount = sessions.length;
+        if (sessionCount > 0 || eventCount > 0) {
+            // Use console.info instead of the logger to avoid circular import.
+            console.info(JSON.stringify({
+                level: 'info',
+                time: new Date().toISOString(),
+                msg: 'Premium memory snapshot',
+                sessions: sessionCount,
+                events: eventCount,
+                maxSessions: this.config.maxSessions,
+                maxEvents: this.config.maxEvents,
+                rssMb: Math.round(memUsage.rss / 1024 / 1024),
+                heapUsedMb: Math.round(memUsage.heapUsed / 1024 / 1024),
+                heapTotalMb: Math.round(memUsage.heapTotal / 1024 / 1024),
+            }));
+        }
+    }
+    /**
+     * @name shutdown
+     * @description Stop the GC interval and clean up all premium stores.
+     *
+     * Called during server graceful shutdown. This:
+     *   1. Stops the GC interval.
+     *   2. Stops all active SSE streams.
+     *   3. Deactivates all webhook subscriptions.
+     *   4. Disconnects all provider adapters.
+     *   5. Clears the session store and event store.
+     */
+    async shutdown() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = undefined;
+        }
+        stopAllStreams();
+        stopAllWebhooks();
+        await disconnectAllProviders();
+        clearAllSessions();
+        clearAllEvents();
+    }
+}
+//# sourceMappingURL=premium-memory.js.map

package/dist/remote/premium-memory.js.map

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

package/dist/remote/premium-routes.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @name remote/premium-routes
+ * @description HTTP route handlers for the premium delivery rail.
+ *
+ * This module owns the 4 premium delivery endpoints that the `RemoteMCPServer`
+ * delegates to. Each handler is an async function that receives the raw
+ * Node.js `IncomingMessage` / `ServerResponse` pair and returns nothing
+ * (the response is written directly).
+ *
+ * Endpoints:
+ *   POST   /premium/activate              — Activate a session with x402 receipt.
+ *   GET    /premium/stream/:sessionId     — SSE stream for an active session.
+ *   POST   /premium/webhook/register      — Register a webhook target.
+ *   GET    /premium/webhook/:subId/status — Check webhook delivery status.
+ *
+ * Design principles:
+ *   - Each handler is pure async — no shared mutable state outside the premium modules.
+ *   - SSE streams use keep-alive with `X-Accel-Buffering: no` for nginx proxies.
+ *   - Webhook delivery runs in the background via `setImmediate` to not block the
+ *     HTTP response — the response returns the subscription immediately.
+ *   - All errors return structured JSON with `error` and `message` fields.
+ *
+ * @module remote/premium-routes
+ */
+import * as http from 'node:http';
+/**
+ * @name handlePremiumActivation
+ * @description Activate a pending premium session with a payment receipt.
+ *
+ * Expects a JSON body:
+ *   { "sessionId": string, "paymentReceipt": string, "payerAddress"?: string }
+ *
+ * Returns:
+ *   - 200 + `{ activation: PremiumActivationResult }` on success.
+ *   - 400 if required fields are missing.
+ *   - 402 if the session is not in `pending_payment` status.
+ *
+ * @param req - HTTP request.
+ * @param res - HTTP response.
+ */
+export declare function handlePremiumActivation(req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/**
+ * @name handlePremiumStream
+ * @description Open an SSE stream for an active premium session.
+ *
+ * The client must send `Accept: text/event-stream`. The server:
+ *   1. Validates the session is active.
+ *   2. Replays past events within the replay window (if `since` query param is set).
+ *   3. Opens a live provider subscription and streams events as SSE.
+ *   4. Closes the stream when the client disconnects or the unit quota is exhausted.
+ *
+ * SSE format per event:
+ *   event: <eventType>\n
+ *   data: {<JSON payload>}\n\n
+ *
+ * @param req        - HTTP request.
+ * @param res        - HTTP response.
+ * @param sessionId  - The session id extracted from the URL path.
+ */
+export declare function handlePremiumStream(req: http.IncomingMessage, res: http.ServerResponse, sessionId: string): Promise<void>;
+/**
+ * @name handlePremiumWebhookRegister
+ * @description Register an HTTPS webhook target for signed event delivery.
+ *
+ * Expects a JSON body:
+ *   { "sessionId": string, "targetUrl": string, "events": string[],
+ *     "signingPublicKey"?: string }
+ *
+ * Returns 201 with the subscription record. The delivery worker starts in the
+ * background via `setImmediate` — the response does not wait for delivery.
+ *
+ * @param req - HTTP request.
+ * @param res - HTTP response.
+ */
+export declare function handlePremiumWebhookRegister(req: http.IncomingMessage, res: http.ServerResponse): Promise<void>;
+/**
+ * @name handlePremiumWebhookStatus
+ * @description Return the status of a webhook subscription with recent delivery records.
+ *
+ * @param req            - HTTP request.
+ * @param res            - HTTP response.
+ * @param subscriptionId - The subscription id extracted from the URL path.
+ */
+export declare function handlePremiumWebhookStatus(req: http.IncomingMessage, res: http.ServerResponse, subscriptionId: string): Promise<void>;
+/**
+ * @name tryPremiumRoute
+ * @description Check if a request targets a premium delivery endpoint and handle it.
+ *
+ * This is the single entry point called by the `RemoteMCPServer` request handler.
+ * If the request matches a premium route, the handler runs and `true` is returned
+ * (indicating the response was written). If no route matches, `false` is returned
+ * and the caller continues to the next route handler.
+ *
+ * @param req - HTTP request.
+ * @param res - HTTP response.
+ * @returns `true` if a premium route handled the request, `false` otherwise.
+ */
+export declare function tryPremiumRoute(req: http.IncomingMessage, res: http.ServerResponse): Promise<boolean>;
+//# sourceMappingURL=premium-routes.d.ts.map

package/dist/remote/premium-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"premium-routes.d.ts","sourceRoot":"","sources":["../../src/remote/premium-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAkElC;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAmFf;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAMD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAcf;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,GACvB,OAAO,CAAC,OAAO,CAAC,CAmClB"}