gitlab-mcp-test 6.62.1

package/dist/src/session-manager.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+exports.getSessionManager = getSessionManager;
+exports.resetSessionManager = resetSessionManager;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const config_1 = require("./config");
+const handlers_1 = require("./handlers");
+const schema_utils_1 = require("./utils/schema-utils");
+const logger_1 = require("./logger");
+const DEFAULT_SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+class SessionManager {
+    sessions = new Map();
+    cleanupInterval = null;
+    sessionTimeoutMs;
+    schemaModeDetected = false;
+    constructor(sessionTimeoutMs) {
+        this.sessionTimeoutMs = sessionTimeoutMs ?? DEFAULT_SESSION_TIMEOUT_MS;
+    }
+    start() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanupStaleSessions();
+        }, 60_000);
+        this.cleanupInterval.unref();
+        (0, logger_1.logInfo)("Session manager started", { sessionTimeoutMs: this.sessionTimeoutMs });
+    }
+    async createSession(sessionId, transport) {
+        if (this.sessions.has(sessionId)) {
+            (0, logger_1.logWarn)("Duplicate sessionId detected — closing existing session", { sessionId });
+            await this.removeSession(sessionId);
+        }
+        const server = new index_js_1.Server({ name: config_1.packageName, version: config_1.packageVersion }, { capabilities: { tools: { listChanged: true } } });
+        server.oninitialized = () => {
+            if (!this.schemaModeDetected) {
+                this.schemaModeDetected = true;
+                const clientVersion = server.getClientVersion();
+                (0, schema_utils_1.setDetectedSchemaMode)(clientVersion?.name);
+            }
+        };
+        await (0, handlers_1.setupHandlers)(server);
+        await server.connect(transport);
+        const now = Date.now();
+        this.sessions.set(sessionId, {
+            server,
+            sessionId,
+            createdAt: now,
+            lastActivityAt: now,
+        });
+        (0, logger_1.logInfo)("Session created", { sessionId, activeSessions: this.sessions.size });
+        return server;
+    }
+    touchSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session) {
+            session.lastActivityAt = Date.now();
+        }
+    }
+    async removeSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return;
+        this.sessions.delete(sessionId);
+        try {
+            await session.server.close();
+        }
+        catch (error) {
+            (0, logger_1.logDebug)("Error closing session server (may already be closed)", { err: error, sessionId });
+        }
+        (0, logger_1.logInfo)("Session removed", { sessionId, activeSessions: this.sessions.size });
+    }
+    async broadcastToolsListChanged() {
+        const promises = [];
+        for (const [sessionId, session] of this.sessions) {
+            promises.push(session.server
+                .notification({ method: "notifications/tools/list_changed" })
+                .then(() => {
+                (0, logger_1.logDebug)("Sent tools/list_changed to session", { sessionId });
+            })
+                .catch((error) => {
+                (0, logger_1.logDebug)("Failed to send tools/list_changed to session", { err: error, sessionId });
+            }));
+        }
+        await Promise.allSettled(promises);
+        (0, logger_1.logInfo)("Broadcast tools/list_changed to all sessions", { sessionCount: this.sessions.size });
+    }
+    get activeSessionCount() {
+        return this.sessions.size;
+    }
+    cleanupStaleSessions() {
+        const now = Date.now();
+        const stale = [];
+        for (const [sessionId, session] of this.sessions) {
+            if (sessionId === "stdio") {
+                continue;
+            }
+            if (now - session.lastActivityAt > this.sessionTimeoutMs) {
+                stale.push(sessionId);
+            }
+        }
+        if (stale.length === 0)
+            return;
+        (0, logger_1.logInfo)("Cleaning up stale sessions", {
+            staleCount: stale.length,
+            activeSessions: this.sessions.size,
+        });
+        for (const sessionId of stale) {
+            this.removeSession(sessionId).catch((error) => {
+                (0, logger_1.logError)("Error during stale session cleanup", { err: error, sessionId });
+            });
+        }
+    }
+    async shutdown() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = null;
+        }
+        const sessionIds = [...this.sessions.keys()];
+        await Promise.allSettled(sessionIds.map(id => this.removeSession(id)));
+        (0, logger_1.logInfo)("Session manager shut down");
+    }
+}
+exports.SessionManager = SessionManager;
+let sessionManagerInstance = null;
+function getSessionManager() {
+    sessionManagerInstance ??= new SessionManager();
+    return sessionManagerInstance;
+}
+function resetSessionManager() {
+    sessionManagerInstance = null;
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/src/session-manager.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,28 @@
+declare const TransportModeObj: {
+    readonly STDIO: "stdio";
+    readonly SSE: "sse";
+    readonly STREAMABLE_HTTP: "streamable-http";
+    readonly DUAL: "dual";
+};
+export { TransportModeObj as TransportMode };
+export type TransportMode = (typeof TransportModeObj)[keyof typeof TransportModeObj];
+export interface GitLabAPIResponse<T = unknown> {
+    data: T;
+    status: number;
+    statusText: string;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface FeatureGate {
+    envVar: string;
+    defaultValue: boolean;
+}
+export interface EnhancedToolDefinition extends ToolDefinition {
+    handler: (args: unknown) => Promise<unknown>;
+    gate?: FeatureGate;
+    idempotent?: boolean;
+}
+export type ToolRegistry = Map<string, EnhancedToolDefinition>;

package/dist/src/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportMode = void 0;
+const TransportModeObj = {
+    STDIO: "stdio",
+    SSE: "sse",
+    STREAMABLE_HTTP: "streamable-http",
+    DUAL: "dual",
+};
+exports.TransportMode = TransportModeObj;
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AACA,MAAM,gBAAgB,GAAG;IACvB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,eAAe,EAAE,iBAAiB;IAClC,IAAI,EAAE,MAAM;CACJ,CAAC;AAEkB,yCAAa"}

package/dist/src/utils/description-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveRelatedReferences(description: string, availableTools: Set<string>): string;
+export declare function stripRelatedSection(description: string): string;

package/dist/src/utils/description-utils.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRelatedReferences = resolveRelatedReferences;
+exports.stripRelatedSection = stripRelatedSection;
+function resolveRelatedReferences(description, availableTools) {
+    const relatedMatch = description.match(/\s*Related:\s*(.+?)\.?\s*$/);
+    if (!relatedMatch)
+        return description;
+    const matchIndex = relatedMatch.index ?? description.length;
+    const baseDescription = description.substring(0, matchIndex);
+    const relatedContent = relatedMatch[1];
+    const items = relatedContent.split(",").map(s => s.trim());
+    const available = items.filter(item => {
+        const toolRef = item.match(/^((?:browse|manage)_\w+)\b/);
+        return toolRef && availableTools.has(toolRef[1]);
+    });
+    if (available.length === 0) {
+        return baseDescription.trimEnd();
+    }
+    return `${baseDescription.trimEnd()} Related: ${available.join(", ")}.`;
+}
+function stripRelatedSection(description) {
+    return description.replace(/\s*Related:\s*(.+?)\.?\s*$/, "").trimEnd();
+}
+//# sourceMappingURL=description-utils.js.map

package/dist/src/utils/description-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"description-utils.js","sourceRoot":"","sources":["../../../src/utils/description-utils.ts"],"names":[],"mappings":";;AAeA,4DAoBC;AASD,kDAEC;AA/BD,SAAgB,wBAAwB,CAAC,WAAmB,EAAE,cAA2B;IACvF,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACrE,IAAI,CAAC,YAAY;QAAE,OAAO,WAAW,CAAC;IAEtC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC;IAC5D,MAAM,eAAe,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAGvC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QACzD,OAAO,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,eAAe,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,aAAa,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAC1E,CAAC;AASD,SAAgB,mBAAmB,CAAC,WAAmB;IACrD,OAAO,WAAW,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;AACzE,CAAC"}

package/dist/src/utils/error-handler.d.ts

@@ -0,0 +1,93 @@
+import { GitLabTier as InternalTier } from "../services/GitLabVersionDetector.js";
+export type GitLabTier = "Free" | "Premium" | "Ultimate";
+export interface StructuredError {
+    error_code: string;
+    tool: string;
+    action: string;
+    message: string;
+    suggested_fix?: string;
+}
+export interface ActionValidationError extends StructuredError {
+    error_code: "MISSING_REQUIRED_FIELD" | "INVALID_ACTION" | "FIELD_NOT_ALLOWED" | "TYPE_MISMATCH" | "VALIDATION_ERROR";
+    missing_fields?: string[];
+    invalid_fields?: Array<{
+        field: string;
+        expected: string;
+        received: string;
+    }>;
+    valid_actions?: string[];
+    action_required_fields?: Record<string, string[]>;
+}
+export interface TierAlternative {
+    action: string;
+    description: string;
+    available_on: GitLabTier;
+}
+export interface TierRestrictedError extends StructuredError {
+    error_code: "TIER_RESTRICTED";
+    http_status: number;
+    tier_required: GitLabTier;
+    current_tier?: GitLabTier;
+    feature_name: string;
+    alternatives?: TierAlternative[];
+    docs_url?: string;
+    upgrade_url?: string;
+}
+export interface PermissionDeniedError extends StructuredError {
+    error_code: "PERMISSION_DENIED";
+    http_status: number;
+    required_access?: string;
+    alternatives?: TierAlternative[];
+}
+export interface NotFoundError extends StructuredError {
+    error_code: "NOT_FOUND";
+    http_status: number;
+    resource_type?: string;
+    resource_id?: string;
+}
+export interface ApiError extends StructuredError {
+    error_code: "API_ERROR" | "RATE_LIMITED" | "SERVER_ERROR";
+    http_status: number;
+    gitlab_error?: string;
+}
+export interface VersionRestrictedError extends StructuredError {
+    error_code: "VERSION_RESTRICTED";
+    widget: string;
+    parameter: string;
+    required_version: string;
+    detected_version: string;
+    required_tier?: GitLabTier;
+    current_tier?: GitLabTier;
+    docs_url?: string;
+}
+export interface TimeoutError extends StructuredError {
+    error_code: "TIMEOUT";
+    timeout_ms: number;
+    retryable: boolean;
+}
+export type GitLabStructuredError = ActionValidationError | TierRestrictedError | VersionRestrictedError | PermissionDeniedError | NotFoundError | ApiError | TimeoutError;
+export declare function normalizeTier(tier: string | InternalTier): GitLabTier;
+export interface GitLabApiErrorResponse {
+    status: number;
+    message?: string;
+    error?: string;
+    error_description?: string;
+}
+export declare function handleGitLabError(error: GitLabApiErrorResponse, tool: string, action: string, toolArgs?: Record<string, unknown>): GitLabStructuredError;
+export declare function createMissingFieldsError(tool: string, action: string, missingFields: string[], actionRequiredFields?: Record<string, string[]>): ActionValidationError;
+export declare function createInvalidActionError(tool: string, action: string, validActions: string[]): ActionValidationError;
+export declare function createTypeMismatchError(tool: string, action: string, field: string, expected: string, received: string): ActionValidationError;
+export declare function createValidationError(tool: string, action: string, zodMessage: string): ActionValidationError;
+export declare function createTimeoutError(tool: string, action: string, timeoutMs: number, retryable?: boolean): TimeoutError;
+export declare function createVersionRestrictedError(tool: string, action: string, widget: string, parameter: string, requiredVersion: string, detectedVersion: string, requiredTier?: GitLabTier, currentTier?: GitLabTier): VersionRestrictedError;
+export declare function parseGitLabApiError(errorMessage: string): {
+    status: number;
+    message: string;
+} | null;
+export declare function parseTimeoutError(errorMessage: string): number | null;
+export declare class StructuredToolError extends Error {
+    readonly structuredError: GitLabStructuredError;
+    constructor(structuredError: GitLabStructuredError);
+    toJSON(): GitLabStructuredError;
+}
+export declare function isStructuredToolError(error: unknown): error is StructuredToolError;