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

package/dist/session/redis-session-store.js

@@ -1,5 +1,6 @@
 /**
- * Redis-backed session store for production deployments
+ * @name session/redis-session-store
+ * @description Redis-backed persistent session store for production SAP MCP deployments.
  *
  * Features:
  * - Persistent sessions across server restarts
@@ -7,28 +8,53 @@
  * - Automatic TTL-based expiration
  * - Memory-safe (no local storage)
  *
- * Usage:
- * ```typescript
- * const store = new RedisSessionStore('redis://localhost:6379');
- * await store.set('session-123', session);
- * const session = await store.get('session-123');
- * ```
+ * @flow
+ *   1. `createSessionStore` checks `SAP_MCP_USE_REDIS` env var and creates a `RedisSessionStore`
+ *      or returns `null` for in-memory development mode.
+ *   2. `RedisSessionStore` manages session CRUD with automatic TTL based on session expiry.
+ *   3. A background cleanup interval removes expired sessions periodically.
+ *
+ * @env `SAP_MCP_USE_REDIS` — Set to `true` to enable Redis session storage.
+ * @env `SAP_MCP_REDIS_URL` — Redis connection URL (default `redis://localhost:6379`).
+ *
+ * @module session/redis-session-store
  */
 import { Redis } from 'ioredis';
 import { logger } from '../core/logger.js';
+/** @description Default configuration values merged with user-provided config. */
 const DEFAULT_CONFIG = {
     redisUrl: 'redis://localhost:6379',
     keyPrefix: 'sap-mcp:session:',
     cleanupIntervalMs: 60 * 60 * 1000, // 1 hour
 };
 /**
- * Runtime service that implements redis session store behavior.
+ * @name RedisSessionStore
+ * @description Persistent session store backed by Redis with TTL-based expiration and periodic cleanup.
+ *
+ * @method connect   — Establish the Redis connection.
+ * @method set        — Store a session with TTL derived from its expiry.
+ * @method get        — Retrieve a session by id.
+ * @method delete     — Remove a session by id.
+ * @method getAll     — Retrieve all active sessions (for debugging/admin).
+ * @method getCount   — Get the total number of stored sessions.
+ * @method cleanup    — Manually remove expired sessions.
+ * @method getStats   — Get session statistics (total, active, expired).
+ * @method shutdown   — Gracefully close the Redis connection and cleanup interval.
+ * @method getClient  — Get the raw Redis client for advanced operations.
+ *
+ * @usedBy `createSessionStore`, distributed SAP MCP deployments.
  */
 export class RedisSessionStore {
     redis;
     keyPrefix;
     cleanupInterval;
     isShuttingDown = false;
+    /**
+     * @name RedisSessionStore.constructor
+     * @description Creates a new Redis session store with merged config and starts the cleanup interval.
+     *
+     * @param config — Optional configuration overriding defaults.
+     */
     constructor(config = DEFAULT_CONFIG) {
         const finalConfig = { ...DEFAULT_CONFIG, ...config };
         this.redis = new Redis(finalConfig.redisUrl, {
@@ -53,14 +79,21 @@ export class RedisSessionStore {
         this.startCleanup(finalConfig.cleanupIntervalMs);
     }
     /**
-     * Connect to Redis
+     * @name RedisSessionStore.connect
+     * @description Connects to the Redis server.
+     *
+     * @usedBy `createSessionStore`.
      */
     async connect() {
         await this.redis.connect();
         logger.info('Redis session store initialized');
     }
     /**
-     * Store a session with TTL
+     * @name RedisSessionStore.set
+     * @description Stores a session in Redis with a TTL derived from its expiry timestamp.
+     *
+     * @param sessionId — Unique session identifier.
+     * @param session   — The agent session to store.
      */
     async set(sessionId, session) {
         const key = this.getKey(sessionId);
@@ -69,7 +102,11 @@ export class RedisSessionStore {
         logger.debug('Session stored in Redis', { sessionId, ttl });
     }
     /**
-     * Get a session
+     * @name RedisSessionStore.get
+     * @description Retrieves a session by id from Redis.
+     *
+     * @param sessionId — Unique session identifier.
+     * @returns The session if found and parseable, `null` otherwise.
      */
     async get(sessionId) {
         const key = this.getKey(sessionId);
@@ -87,7 +124,11 @@ export class RedisSessionStore {
         }
     }
     /**
-     * Delete a session
+     * @name RedisSessionStore.delete
+     * @description Deletes a session from Redis by id.
+     *
+     * @param sessionId — Unique session identifier.
+     * @returns `true` if the session was deleted, `false` if it did not exist.
      */
     async delete(sessionId) {
         const key = this.getKey(sessionId);
@@ -96,7 +137,10 @@ export class RedisSessionStore {
         return result > 0;
     }
     /**
-     * Get all active sessions (for debugging/admin)
+     * @name RedisSessionStore.getAll
+     * @description Retrieves all active sessions from Redis (for debugging/admin).
+     *
+     * @returns Array of all stored agent sessions.
      */
     async getAll() {
         const keys = await this.redis.keys(`${this.keyPrefix}*`);
@@ -115,14 +159,18 @@ export class RedisSessionStore {
         return sessions;
     }
     /**
-     * Get session count
+     * @name RedisSessionStore.getCount
+     * @description Returns the total number of stored sessions.
+     *
+     * @returns Count of session keys in Redis.
      */
     async getCount() {
         const keys = await this.redis.keys(`${this.keyPrefix}*`);
         return keys.length;
     }
     /**
-     * Clean up expired sessions (manual trigger)
+     * @name RedisSessionStore.cleanup
+     * @description Manually removes expired sessions from Redis.
      */
     async cleanup() {
         const keys = await this.redis.keys(`${this.keyPrefix}*`);
@@ -137,7 +185,10 @@ export class RedisSessionStore {
         logger.debug('Redis session cleanup', { cleaned });
     }
     /**
-     * Get session statistics
+     * @name RedisSessionStore.getStats
+     * @description Returns session statistics (total, active, expired).
+     *
+     * @returns Object with `totalSessions`, `activeSessions`, and `expiredSessions` counts.
      */
     async getStats() {
         const keys = await this.redis.keys(`${this.keyPrefix}*`);
@@ -168,7 +219,8 @@ export class RedisSessionStore {
         };
     }
     /**
-     * Graceful shutdown
+     * @name RedisSessionStore.shutdown
+     * @description Gracefully shuts down the Redis connection and clears the cleanup interval.
      */
     async shutdown() {
         this.isShuttingDown = true;
@@ -179,14 +231,19 @@ export class RedisSessionStore {
         logger.info('Redis session store shut down');
     }
     /**
-     * Get Redis client (for advanced operations)
+     * @name RedisSessionStore.getClient
+     * @description Returns the raw Redis client instance for advanced operations.
+     *
+     * @returns The underlying `ioredis` Redis instance.
      */
     getClient() {
         return this.redis;
     }
+    /** @description Builds the full Redis key from the prefix and session id. */
     getKey(sessionId) {
         return `${this.keyPrefix}${sessionId}`;
     }
+    /** @description Starts the periodic cleanup interval for expired sessions. */
     startCleanup(intervalMs) {
         this.cleanupInterval = setInterval(async () => {
             if (this.isShuttingDown)
@@ -201,9 +258,19 @@ export class RedisSessionStore {
     }
 }
 /**
- * Create session store with environment-based configuration
+ * @name createSessionStore
+ * @description Creates a session store based on environment configuration.
+ *
+ * Uses Redis in production (when `SAP_MCP_USE_REDIS=true`) and in-memory
+ * storage in development (returns `null`).
+ *
+ * @returns A connected `RedisSessionStore` if Redis is enabled, `null` otherwise.
+ * @throws If Redis connection fails after retries.
+ *
+ * @env `SAP_MCP_USE_REDIS` — Set to `true` to enable Redis.
+ * @env `SAP_MCP_REDIS_URL` — Redis connection URL (default `redis://localhost:6379`).
  *
- * Uses Redis in production, in-memory in development
+ * @usedBy Server initialization in the SAP MCP runtime.
  */
 export async function createSessionStore() {
     const useRedis = process.env.SAP_MCP_USE_REDIS === 'true';

package/dist/session/redis-session-store.js.map

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

package/dist/session/session-limits.d.ts

@@ -1,20 +1,50 @@
 /**
- * Session spending limits management
+ * @name session/session-limits
+ * @description Session spending limit management — per-transaction checks, balance deduction, and daily resets.
+ *
+ * @flow
+ *   1. `checkSpendingLimit` validates a transaction amount against per-transaction and remaining session limits.
+ *   2. `deductFromSession` subtracts a spent amount from the session's remaining balance.
+ *   3. `resetDailyLimits` resets the session's remaining balance to the maximum per-session limit.
+ *
+ * @module session/session-limits
  */
 import type { SapAgentSession, SapSpendingLimits } from '../core/types.js';
 /**
- * Check if transaction is within limits
+ * @name checkSpendingLimit
+ * @description Checks whether a transaction amount is within the session's spending limits.
+ *
+ * @param session   — The agent session to check against.
+ * @param amountSol — The transaction amount in SOL to validate.
+ * @returns `{ allowed: true }` if within limits; `{ allowed: false, reason }` with an explanation otherwise.
+ *
+ * @usedBy Tool handlers across the SAP MCP runtime.
  */
 export declare function checkSpendingLimit(session: SapAgentSession, amountSol: number): {
     allowed: boolean;
     reason?: string;
 };
 /**
- * Deduct amount from session balance
+ * @name deductFromSession
+ * @description Deducts a spent amount from the session's remaining SOL balance and returns the updated limits.
+ *
+ * @param session   — The agent session to deduct from.
+ * @param amountSol — The amount in SOL to deduct.
+ * @returns A new `SapSpendingLimits` object with the updated `remainingSessionSol`.
+ *
+ * @usedBy Tool handlers across the SAP MCP runtime.
  */
 export declare function deductFromSession(session: SapAgentSession, amountSol: number): SapSpendingLimits;
 /**
- * Reset daily limits (called periodically)
+ * @name resetDailyLimits
+ * @description Resets the session's remaining SOL balance to the maximum per-session limit.
+ *
+ * Called periodically to reset daily spending counters. In production, a separate
+ * daily counter stored in Redis/DB would be reset here.
+ *
+ * @param session — The agent session whose limits to reset.
+ *
+ * @usedBy Scheduled limit reset tasks in the SAP MCP runtime.
  */
 export declare function resetDailyLimits(session: SapAgentSession): void;
 //# sourceMappingURL=session-limits.d.ts.map

package/dist/session/session-limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-limits.d.ts","sourceRoot":"","sources":["../../src/session/session-limits.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAanB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAY/D"}
+{"version":3,"file":"session-limits.d.ts","sourceRoot":"","sources":["../../src/session/session-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAoBvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAanB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAY/D"}

package/dist/session/session-limits.js

@@ -1,9 +1,24 @@
 /**
- * Session spending limits management
+ * @name session/session-limits
+ * @description Session spending limit management — per-transaction checks, balance deduction, and daily resets.
+ *
+ * @flow
+ *   1. `checkSpendingLimit` validates a transaction amount against per-transaction and remaining session limits.
+ *   2. `deductFromSession` subtracts a spent amount from the session's remaining balance.
+ *   3. `resetDailyLimits` resets the session's remaining balance to the maximum per-session limit.
+ *
+ * @module session/session-limits
  */
 import { logger } from '../core/logger.js';
 /**
- * Check if transaction is within limits
+ * @name checkSpendingLimit
+ * @description Checks whether a transaction amount is within the session's spending limits.
+ *
+ * @param session   — The agent session to check against.
+ * @param amountSol — The transaction amount in SOL to validate.
+ * @returns `{ allowed: true }` if within limits; `{ allowed: false, reason }` with an explanation otherwise.
+ *
+ * @usedBy Tool handlers across the SAP MCP runtime.
  */
 export function checkSpendingLimit(session, amountSol) {
     const limits = session.spendingLimits;
@@ -24,7 +39,14 @@ export function checkSpendingLimit(session, amountSol) {
     return { allowed: true };
 }
 /**
- * Deduct amount from session balance
+ * @name deductFromSession
+ * @description Deducts a spent amount from the session's remaining SOL balance and returns the updated limits.
+ *
+ * @param session   — The agent session to deduct from.
+ * @param amountSol — The amount in SOL to deduct.
+ * @returns A new `SapSpendingLimits` object with the updated `remainingSessionSol`.
+ *
+ * @usedBy Tool handlers across the SAP MCP runtime.
  */
 export function deductFromSession(session, amountSol) {
     const newLimits = {
@@ -39,7 +61,15 @@ export function deductFromSession(session, amountSol) {
     return newLimits;
 }
 /**
- * Reset daily limits (called periodically)
+ * @name resetDailyLimits
+ * @description Resets the session's remaining SOL balance to the maximum per-session limit.
+ *
+ * Called periodically to reset daily spending counters. In production, a separate
+ * daily counter stored in Redis/DB would be reset here.
+ *
+ * @param session — The agent session whose limits to reset.
+ *
+ * @usedBy Scheduled limit reset tasks in the SAP MCP runtime.
  */
 export function resetDailyLimits(session) {
     // Reset daily spending counter (if tracked separately)

package/dist/session/session-limits.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-limits.js","sourceRoot":"","sources":["../../src/session/session-limits.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,SAAiB;IAEjB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAEtC,8BAA8B;IAC9B,IAAI,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,UAAU,SAAS,sCAAsC,MAAM,CAAC,oBAAoB,MAAM;SACnG,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,SAAS,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,UAAU,SAAS,0CAA0C,MAAM,CAAC,mBAAmB,MAAM;SACtG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EACxB,SAAiB;IAEjB,MAAM,SAAS,GAAG;QAChB,GAAG,OAAO,CAAC,cAAc;QACzB,mBAAmB,EAAE,OAAO,CAAC,cAAc,CAAC,mBAAmB,GAAG,SAAS;KAC5E,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS;QACT,YAAY,EAAE,SAAS,CAAC,mBAAmB;KAC5C,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,uDAAuD;IACvD,8CAA8C;IAC9C,8EAA8E;IAE9E,OAAO,CAAC,cAAc,CAAC,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAErF,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,YAAY;QACjD,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,gBAAgB;KAC1D,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"session-limits.js","sourceRoot":"","sources":["../../src/session/session-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,SAAiB;IAEjB,MAAM,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAEtC,8BAA8B;IAC9B,IAAI,SAAS,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC;QAC5C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,UAAU,SAAS,sCAAsC,MAAM,CAAC,oBAAoB,MAAM;SACnG,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,SAAS,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,UAAU,SAAS,0CAA0C,MAAM,CAAC,mBAAmB,MAAM;SACtG,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAwB,EACxB,SAAiB;IAEjB,MAAM,SAAS,GAAG;QAChB,GAAG,OAAO,CAAC,cAAc;QACzB,mBAAmB,EAAE,OAAO,CAAC,cAAc,CAAC,mBAAmB,GAAG,SAAS;KAC5E,CAAC;IAEF,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACpC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS;QACT,YAAY,EAAE,SAAS,CAAC,mBAAmB;KAC5C,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,uDAAuD;IACvD,8CAA8C;IAC9C,8EAA8E;IAE9E,OAAO,CAAC,cAAc,CAAC,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC;IAErF,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,YAAY;QACjD,gBAAgB,EAAE,OAAO,CAAC,cAAc,CAAC,gBAAgB;KAC1D,CAAC,CAAC;AACL,CAAC"}

package/dist/session/session-permissions.d.ts

@@ -1,13 +1,39 @@
 /**
- * Session permissions management
+ * @name session/session-permissions
+ * @description Session permission definitions, categories, and utility functions for the SAP MCP runtime.
+ *
+ * Defines the full set of permissions, groups them by category, and provides
+ * helpers for validation, category lookups, and read/write classification.
+ *
+ * @flow
+ *   1. `ALL_PERMISSIONS` defines the canonical list of allowed permission strings.
+ *   2. `PERMISSION_CATEGORIES` groups permissions by domain (registry, identity, payments, etc.).
+ *   3. Utility functions (`isValidPermission`, `getPermissionsByCategory`, `isWritePermission`,
+ *      `toReadPermission`) are used by session creation and validation logic.
+ *
+ * @module session/session-permissions
  */
 import type { SapPermission } from '../core/types.js';
 /**
- * All available permissions
+ * @name ALL_PERMISSIONS
+ * @description The canonical list of all permissions recognized by the SAP MCP runtime.
+ *
+ * @usedBy `isValidPermission`, `agent-session.ts`, `delegated-session.ts`
  */
 export declare const ALL_PERMISSIONS: SapPermission[];
 /**
- * Permission categories
+ * @name PERMISSION_CATEGORIES
+ * @description Permission groups keyed by domain category.
+ *
+ * @property registry     — Registry read/write permissions.
+ * @property identity     — Identity read/write permissions.
+ * @property reputation   — Reputation read/write permissions.
+ * @property payments     — Payments read/write permissions.
+ * @property settlement   — Settlement read/write permissions.
+ * @property memory       — Memory read/write permissions.
+ * @property transaction  — Transaction submission permission.
+ *
+ * @usedBy `getPermissionsByCategory`, permission UI in the TUI wizard.
  */
 export declare const PERMISSION_CATEGORIES: {
     readonly registry: readonly ["registry:read", "registry:write"];
@@ -19,19 +45,43 @@ export declare const PERMISSION_CATEGORIES: {
     readonly transaction: readonly ["transaction:submit"];
 };
 /**
- * Check if permission is valid
+ * @name isValidPermission
+ * @description Checks whether a permission string is in the canonical `ALL_PERMISSIONS` list.
+ *
+ * @param permission — Permission string to validate.
+ * @returns `true` if the permission is recognized, `false` otherwise.
+ *
+ * @usedBy `agent-session.ts:createAgentSession`, `core/guards.ts`
  */
 export declare function isValidPermission(permission: string): boolean;
 /**
- * Get permissions by category
+ * @name getPermissionsByCategory
+ * @description Returns all permissions belonging to a specific category.
+ *
+ * @param category — Category key from `PERMISSION_CATEGORIES`.
+ * @returns Array of permissions in the specified category.
+ *
+ * @usedBy Permission UI and session creation logic.
  */
 export declare function getPermissionsByCategory(category: keyof typeof PERMISSION_CATEGORIES): SapPermission[];
 /**
- * Check if permission is write permission
+ * @name isWritePermission
+ * @description Checks whether a permission is a write-level permission (ends with `:write`).
+ *
+ * @param permission — Permission string to check.
+ * @returns `true` if the permission grants write access, `false` otherwise.
+ *
+ * @usedBy Session validation and policy enforcement.
  */
 export declare function isWritePermission(permission: SapPermission): boolean;
 /**
- * Get read-only version of permission
+ * @name toReadPermission
+ * @description Converts a write permission to its read-only counterpart by replacing `:write` with `:read`.
+ *
+ * @param permission — Permission string to convert.
+ * @returns The read-only version of the permission.
+ *
+ * @usedBy Session downgrade logic and read-only mode enforcement.
  */
 export declare function toReadPermission(permission: SapPermission): SapPermission;
 //# sourceMappingURL=session-permissions.d.ts.map

package/dist/session/session-permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-permissions.d.ts","sourceRoot":"","sources":["../../src/session/session-permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAc1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;CAQ2B,CAAC;AAE9D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,OAAO,qBAAqB,GAAG,aAAa,EAAE,CAEtG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,CAEzE"}
+{"version":3,"file":"session-permissions.d.ts","sourceRoot":"","sources":["../../src/session/session-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAc1C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;CAQ2B,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,OAAO,qBAAqB,GAAG,aAAa,EAAE,CAEtG;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,aAAa,GAAG,aAAa,CAEzE"}

package/dist/session/session-permissions.js

@@ -1,8 +1,23 @@
 /**
- * Session permissions management
+ * @name session/session-permissions
+ * @description Session permission definitions, categories, and utility functions for the SAP MCP runtime.
+ *
+ * Defines the full set of permissions, groups them by category, and provides
+ * helpers for validation, category lookups, and read/write classification.
+ *
+ * @flow
+ *   1. `ALL_PERMISSIONS` defines the canonical list of allowed permission strings.
+ *   2. `PERMISSION_CATEGORIES` groups permissions by domain (registry, identity, payments, etc.).
+ *   3. Utility functions (`isValidPermission`, `getPermissionsByCategory`, `isWritePermission`,
+ *      `toReadPermission`) are used by session creation and validation logic.
+ *
+ * @module session/session-permissions
  */
 /**
- * All available permissions
+ * @name ALL_PERMISSIONS
+ * @description The canonical list of all permissions recognized by the SAP MCP runtime.
+ *
+ * @usedBy `isValidPermission`, `agent-session.ts`, `delegated-session.ts`
  */
 export const ALL_PERMISSIONS = [
     'registry:read',
@@ -20,7 +35,18 @@ export const ALL_PERMISSIONS = [
     'transaction:submit',
 ];
 /**
- * Permission categories
+ * @name PERMISSION_CATEGORIES
+ * @description Permission groups keyed by domain category.
+ *
+ * @property registry     — Registry read/write permissions.
+ * @property identity     — Identity read/write permissions.
+ * @property reputation   — Reputation read/write permissions.
+ * @property payments     — Payments read/write permissions.
+ * @property settlement   — Settlement read/write permissions.
+ * @property memory       — Memory read/write permissions.
+ * @property transaction  — Transaction submission permission.
+ *
+ * @usedBy `getPermissionsByCategory`, permission UI in the TUI wizard.
  */
 export const PERMISSION_CATEGORIES = {
     registry: ['registry:read', 'registry:write'],
@@ -32,25 +58,49 @@ export const PERMISSION_CATEGORIES = {
     transaction: ['transaction:submit'],
 };
 /**
- * Check if permission is valid
+ * @name isValidPermission
+ * @description Checks whether a permission string is in the canonical `ALL_PERMISSIONS` list.
+ *
+ * @param permission — Permission string to validate.
+ * @returns `true` if the permission is recognized, `false` otherwise.
+ *
+ * @usedBy `agent-session.ts:createAgentSession`, `core/guards.ts`
  */
 export function isValidPermission(permission) {
     return ALL_PERMISSIONS.includes(permission);
 }
 /**
- * Get permissions by category
+ * @name getPermissionsByCategory
+ * @description Returns all permissions belonging to a specific category.
+ *
+ * @param category — Category key from `PERMISSION_CATEGORIES`.
+ * @returns Array of permissions in the specified category.
+ *
+ * @usedBy Permission UI and session creation logic.
  */
 export function getPermissionsByCategory(category) {
     return [...PERMISSION_CATEGORIES[category]];
 }
 /**
- * Check if permission is write permission
+ * @name isWritePermission
+ * @description Checks whether a permission is a write-level permission (ends with `:write`).
+ *
+ * @param permission — Permission string to check.
+ * @returns `true` if the permission grants write access, `false` otherwise.
+ *
+ * @usedBy Session validation and policy enforcement.
  */
 export function isWritePermission(permission) {
     return permission.endsWith(':write');
 }
 /**
- * Get read-only version of permission
+ * @name toReadPermission
+ * @description Converts a write permission to its read-only counterpart by replacing `:write` with `:read`.
+ *
+ * @param permission — Permission string to convert.
+ * @returns The read-only version of the permission.
+ *
+ * @usedBy Session downgrade logic and read-only mode enforcement.
  */
 export function toReadPermission(permission) {
     return permission.replace(':write', ':read');

package/dist/session/session-permissions.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-permissions.js","sourceRoot":"","sources":["../../src/session/session-permissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,oBAAoB;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,UAAU,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACnD,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,UAAU,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACnD,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,WAAW,EAAE,CAAC,oBAAoB,CAAC;CACwB,CAAC;AAE9D;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,eAAe,CAAC,QAAQ,CAAC,UAA2B,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA4C;IACnF,OAAO,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB;IACzD,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAyB;IACxD,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAkB,CAAC;AAChE,CAAC"}
+{"version":3,"file":"session-permissions.js","sourceRoot":"","sources":["../../src/session/session-permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,aAAa;IACb,cAAc;IACd,oBAAoB;CACrB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,UAAU,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACnD,QAAQ,EAAE,CAAC,eAAe,EAAE,gBAAgB,CAAC;IAC7C,UAAU,EAAE,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IACnD,MAAM,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,WAAW,EAAE,CAAC,oBAAoB,CAAC;CACwB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,eAAe,CAAC,QAAQ,CAAC,UAA2B,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAA4C;IACnF,OAAO,CAAC,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAyB;IACzD,OAAO,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAyB;IACxD,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAkB,CAAC;AAChE,CAAC"}

package/dist/session/session-store.d.ts

@@ -34,5 +34,13 @@ declare class SessionStore {
     getAll(): SapAgentSession[];
 }
 declare const store: SessionStore;
-export { store as sessionStore };
+/**
+ * @name clearSessionCleanupTimer
+ * @description Stop the hourly cleanup interval. Called during graceful
+ *   shutdown and in test teardown to prevent timer leaks.
+ *
+ * @internal
+ */
+declare function clearSessionCleanupTimer(): void;
+export { store as sessionStore, clearSessionCleanupTimer };
 //# sourceMappingURL=session-store.d.ts.map

package/dist/session/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAA2C;IAE3D;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAKtD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMlC;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;CAG5B;AAGD,QAAA,MAAM,KAAK,cAAqB,CAAC;AAKjC,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,cAAM,YAAY;IAChB,OAAO,CAAC,QAAQ,CAA2C;IAE3D;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAKtD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAInD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAMlC;;OAEG;IACH,OAAO,IAAI,IAAI;IAcf;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;CAG5B;AAGD,QAAA,MAAM,KAAK,cAAqB,CAAC;AAUjC;;;;;;GAMG;AACH,iBAAS,wBAAwB,IAAI,IAAI,CAExC;AAED,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/session/session-store.js

@@ -56,7 +56,22 @@ class SessionStore {
 }
 // Singleton instance
 const store = new SessionStore();
-// Cleanup every hour
-setInterval(() => store.cleanup(), 60 * 60 * 1000);
-export { store as sessionStore };
+/**
+ * @description Hourly cleanup interval for the singleton session store.
+ * Uses `.unref()` so the timer does not keep the process alive during
+ * graceful shutdown.
+ */
+const sessionCleanupTimer = setInterval(() => store.cleanup(), 60 * 60 * 1000);
+sessionCleanupTimer.unref();
+/**
+ * @name clearSessionCleanupTimer
+ * @description Stop the hourly cleanup interval. Called during graceful
+ *   shutdown and in test teardown to prevent timer leaks.
+ *
+ * @internal
+ */
+function clearSessionCleanupTimer() {
+    clearInterval(sessionCleanupTimer);
+}
+export { store as sessionStore, clearSessionCleanupTimer };
 //# sourceMappingURL=session-store.js.map

package/dist/session/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,MAAM,YAAY;IACR,QAAQ,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE3D;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAChC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;AAEjC,qBAAqB;AACrB,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAEnD,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,CAAC"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/session/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,MAAM,YAAY;IACR,QAAQ,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE3D;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3D,IAAI,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAChC,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF;AAED,qBAAqB;AACrB,MAAM,KAAK,GAAG,IAAI,YAAY,EAAE,CAAC;AAEjC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC/E,mBAAmB,CAAC,KAAK,EAAE,CAAC;AAE5B;;;;;;GAMG;AACH,SAAS,wBAAwB;IAC/B,aAAa,CAAC,mBAAmB,CAAC,CAAC;AACrC,CAAC;AAED,OAAO,EAAE,KAAK,IAAI,YAAY,EAAE,wBAAwB,EAAE,CAAC"}