gitlab-mcp-test 6.62.1

package/dist/src/services/SchemaIntrospector.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaIntrospector = void 0;
+const graphql_tag_1 = require("graphql-tag");
+const logger_1 = require("../logger");
+const INTROSPECTION_QUERY = (0, graphql_tag_1.gql) `
+  query IntrospectSchema {
+    __schema {
+      types {
+        name
+        kind
+        fields {
+          name
+          type {
+            name
+            kind
+            ofType {
+              name
+              kind
+            }
+          }
+        }
+        enumValues {
+          name
+          description
+        }
+      }
+    }
+  }
+`;
+class SchemaIntrospector {
+    client;
+    cachedSchema = null;
+    constructor(client) {
+        this.client = client;
+    }
+    async introspectSchema() {
+        if (this.cachedSchema) {
+            return this.cachedSchema;
+        }
+        try {
+            (0, logger_1.logDebug)("Introspecting GitLab GraphQL schema...");
+            const result = await this.client.request(INTROSPECTION_QUERY);
+            const types = result.__schema.types;
+            const workItemWidgetType = types.find(type => type.name === "WorkItemWidgetType");
+            const workItemWidgetTypes = workItemWidgetType?.enumValues?.map(value => value.name) ?? [];
+            const typeDefinitions = new Map();
+            const relevantTypes = types.filter(type => type.name &&
+                (type.name.startsWith("WorkItem") ||
+                    type.name.includes("Widget") ||
+                    type.name === "AwardEmoji" ||
+                    type.name === "Milestone" ||
+                    type.name === "User" ||
+                    type.name === "Label"));
+            for (const type of relevantTypes) {
+                typeDefinitions.set(type.name, {
+                    name: type.name,
+                    fields: type.fields ?? null,
+                    enumValues: type.enumValues ?? null,
+                });
+            }
+            const availableFeatures = new Set();
+            for (const widgetType of workItemWidgetTypes) {
+                availableFeatures.add(widgetType);
+            }
+            this.cachedSchema = {
+                workItemWidgetTypes,
+                typeDefinitions,
+                availableFeatures,
+            };
+            (0, logger_1.logInfo)("GraphQL schema introspection completed", {
+                widgetTypes: workItemWidgetTypes.length,
+                typeDefinitions: typeDefinitions.size,
+                features: availableFeatures.size,
+            });
+            return this.cachedSchema;
+        }
+        catch (error) {
+            (0, logger_1.logWarn)("Schema introspection failed, using fallback schema info", {
+                err: error,
+            });
+            this.cachedSchema = {
+                workItemWidgetTypes: [
+                    "ASSIGNEES",
+                    "LABELS",
+                    "MILESTONE",
+                    "DESCRIPTION",
+                    "START_AND_DUE_DATE",
+                    "WEIGHT",
+                    "TIME_TRACKING",
+                    "HEALTH_STATUS",
+                    "COLOR",
+                    "NOTIFICATIONS",
+                    "NOTES",
+                ],
+                typeDefinitions: new Map(),
+                availableFeatures: new Set(["workItems", "epics", "issues"]),
+            };
+            return this.cachedSchema;
+        }
+    }
+    isWidgetTypeAvailable(widgetType) {
+        if (!this.cachedSchema) {
+            throw new Error("Schema not introspected yet. Call introspectSchema() first.");
+        }
+        return this.cachedSchema.availableFeatures.has(widgetType);
+    }
+    getFieldsForType(typeName) {
+        if (!this.cachedSchema) {
+            throw new Error("Schema not introspected yet. Call introspectSchema() first.");
+        }
+        const typeInfo = this.cachedSchema.typeDefinitions.get(typeName);
+        if (typeInfo?.fields) {
+            return typeInfo.fields;
+        }
+        if (typeName === "WorkItemWidgetAssignees") {
+            return [{ name: "assignees", type: { name: "UserConnection", kind: "OBJECT" } }];
+        }
+        if (typeName === "WorkItemWidgetLabels") {
+            return [{ name: "labels", type: { name: "LabelConnection", kind: "OBJECT" } }];
+        }
+        if (typeName === "WorkItemWidgetMilestone") {
+            return [{ name: "milestone", type: { name: "Milestone", kind: "OBJECT" } }];
+        }
+        return [];
+    }
+    hasField(typeName, fieldName) {
+        const fields = this.getFieldsForType(typeName);
+        return fields.some(field => field.name === fieldName);
+    }
+    getAvailableWidgetTypes() {
+        if (!this.cachedSchema) {
+            throw new Error("Schema not introspected yet. Call introspectSchema() first.");
+        }
+        return this.cachedSchema.workItemWidgetTypes;
+    }
+    generateSafeWidgetQuery(requestedWidgets) {
+        if (!this.cachedSchema) {
+            throw new Error("Schema not introspected yet. Call introspectSchema() first.");
+        }
+        const safeWidgets = [];
+        for (const widget of requestedWidgets) {
+            if (this.isWidgetTypeAvailable(widget)) {
+                const widgetTypeName = `WorkItemWidget${widget.charAt(0) +
+                    widget
+                        .slice(1)
+                        .toLowerCase()
+                        .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase())}`;
+                const fields = this.getFieldsForType(widgetTypeName);
+                const safeFields = this.generateSafeFieldSelections(fields);
+                if (safeFields.length > 0) {
+                    safeWidgets.push(`
+            ... on ${widgetTypeName} {
+              ${safeFields.join("\n              ")}
+            }
+          `);
+                }
+            }
+        }
+        return safeWidgets.join("\n");
+    }
+    generateSafeFieldSelections(fields) {
+        const safeFields = [];
+        for (const field of fields) {
+            if (field.type.kind === "SCALAR" || field.type.kind === "ENUM") {
+                safeFields.push(field.name);
+            }
+            else if (field.type.kind === "OBJECT" && field.name !== "type") {
+                if (field.name === "milestone") {
+                    safeFields.push(`${field.name} { id title state }`);
+                }
+                else if (field.name === "assignees" || field.name === "participants") {
+                    safeFields.push(`${field.name} { nodes { id username } }`);
+                }
+                else if (field.name === "labels") {
+                    safeFields.push(`${field.name} { nodes { id title color } }`);
+                }
+            }
+        }
+        return safeFields;
+    }
+    getCachedSchema() {
+        return this.cachedSchema;
+    }
+    clearCache() {
+        this.cachedSchema = null;
+    }
+}
+exports.SchemaIntrospector = SchemaIntrospector;
+//# sourceMappingURL=SchemaIntrospector.js.map

package/dist/src/services/SchemaIntrospector.js.map

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

package/dist/src/services/TokenScopeDetector.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+export type GitLabTokenType = "personal_access_token" | "project_access_token" | "group_access_token" | "oauth" | "unknown";
+declare const GitLabScopeSchema: z.ZodEnum<{
+    api: "api";
+    read_api: "read_api";
+    read_user: "read_user";
+    read_repository: "read_repository";
+    write_repository: "write_repository";
+    read_registry: "read_registry";
+    write_registry: "write_registry";
+    sudo: "sudo";
+    admin_mode: "admin_mode";
+    create_runner: "create_runner";
+    manage_runner: "manage_runner";
+    ai_features: "ai_features";
+    k8s_proxy: "k8s_proxy";
+}>;
+export type GitLabScope = z.infer<typeof GitLabScopeSchema>;
+export interface TokenScopeInfo {
+    name: string;
+    scopes: GitLabScope[];
+    expiresAt: string | null;
+    active: boolean;
+    tokenType: GitLabTokenType;
+    hasGraphQLAccess: boolean;
+    hasWriteAccess: boolean;
+    daysUntilExpiry: number | null;
+}
+export declare function detectTokenScopes(): Promise<TokenScopeInfo | null>;
+export declare function isToolAvailableForScopes(toolName: string, scopes: GitLabScope[]): boolean;
+export declare function getToolsForScopes(scopes: GitLabScope[]): string[];
+export declare function getToolScopeRequirements(): Record<string, GitLabScope[]>;
+export declare function getTokenCreationUrl(baseUrl: string, scopes?: string[]): string;
+export declare function logTokenScopeInfo(info: TokenScopeInfo, totalTools: number): void;
+export {};

package/dist/src/services/TokenScopeDetector.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectTokenScopes = detectTokenScopes;
+exports.isToolAvailableForScopes = isToolAvailableForScopes;
+exports.getToolsForScopes = getToolsForScopes;
+exports.getToolScopeRequirements = getToolScopeRequirements;
+exports.getTokenCreationUrl = getTokenCreationUrl;
+exports.logTokenScopeInfo = logTokenScopeInfo;
+const zod_1 = require("zod");
+const logger_1 = require("../logger");
+const config_1 = require("../config");
+const fetch_1 = require("../utils/fetch");
+const GITLAB_SCOPES = [
+    "api",
+    "read_api",
+    "read_user",
+    "read_repository",
+    "write_repository",
+    "read_registry",
+    "write_registry",
+    "sudo",
+    "admin_mode",
+    "create_runner",
+    "manage_runner",
+    "ai_features",
+    "k8s_proxy",
+];
+const GitLabScopeSchema = zod_1.z.enum(GITLAB_SCOPES);
+const TokenSelfResponseSchema = zod_1.z.object({
+    id: zod_1.z.number(),
+    name: zod_1.z.string(),
+    scopes: zod_1.z
+        .array(zod_1.z.string())
+        .transform(arr => arr.filter((s) => GitLabScopeSchema.safeParse(s).success)),
+    expires_at: zod_1.z.string().nullable(),
+    active: zod_1.z.boolean(),
+    revoked: zod_1.z.boolean(),
+});
+const TOOL_SCOPE_REQUIREMENTS = {
+    browse_projects: ["api", "read_api"],
+    browse_namespaces: ["api", "read_api"],
+    browse_commits: ["api", "read_api"],
+    browse_events: ["api", "read_api", "read_user"],
+    browse_users: ["api", "read_api", "read_user"],
+    browse_todos: ["api", "read_api"],
+    manage_project: ["api"],
+    manage_namespace: ["api"],
+    manage_todos: ["api"],
+    browse_labels: ["api", "read_api"],
+    manage_label: ["api"],
+    browse_merge_requests: ["api", "read_api"],
+    browse_mr_discussions: ["api", "read_api"],
+    manage_merge_request: ["api"],
+    manage_mr_discussion: ["api"],
+    manage_draft_notes: ["api"],
+    browse_files: ["api", "read_api", "read_repository"],
+    manage_files: ["api", "write_repository"],
+    browse_milestones: ["api", "read_api"],
+    manage_milestone: ["api"],
+    browse_pipelines: ["api", "read_api"],
+    manage_pipeline: ["api"],
+    manage_pipeline_job: ["api"],
+    browse_variables: ["api", "read_api"],
+    manage_variable: ["api"],
+    browse_wiki: ["api", "read_api"],
+    manage_wiki: ["api"],
+    browse_work_items: ["api", "read_api"],
+    manage_work_item: ["api"],
+    browse_snippets: ["api", "read_api"],
+    manage_snippet: ["api"],
+    browse_webhooks: ["api", "read_api"],
+    manage_webhook: ["api"],
+    browse_integrations: ["api", "read_api"],
+    manage_integration: ["api"],
+    browse_releases: ["api", "read_api"],
+    manage_release: ["api"],
+    browse_refs: ["api", "read_api"],
+    manage_ref: ["api"],
+    browse_members: ["api", "read_api"],
+    manage_member: ["api"],
+    browse_search: ["api", "read_api"],
+    browse_iterations: ["api", "read_api"],
+};
+async function detectTokenScopes() {
+    if (!config_1.GITLAB_BASE_URL || !config_1.GITLAB_TOKEN) {
+        return null;
+    }
+    try {
+        const response = await (0, fetch_1.enhancedFetch)(`${config_1.GITLAB_BASE_URL}/api/v4/personal_access_tokens/self`, {
+            headers: {
+                "PRIVATE-TOKEN": config_1.GITLAB_TOKEN,
+                Accept: "application/json",
+            },
+            retry: false,
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                (0, logger_1.logDebug)("Token self-introspection endpoint not available (older GitLab version)");
+                return null;
+            }
+            if (response.status === 401) {
+                (0, logger_1.logInfo)("Token is invalid or expired");
+                return null;
+            }
+            if (response.status === 403) {
+                (0, logger_1.logDebug)("Token self-introspection not permitted for this token type");
+                return null;
+            }
+            (0, logger_1.logDebug)("Unexpected response from token self-introspection", { status: response.status });
+            return null;
+        }
+        const raw = await response.json();
+        const parsed = TokenSelfResponseSchema.safeParse(raw);
+        if (!parsed.success) {
+            (0, logger_1.logDebug)("Token self-introspection response validation failed", {
+                error: parsed.error.message,
+            });
+            return null;
+        }
+        const data = parsed.data;
+        const scopes = data.scopes;
+        const hasGraphQLAccess = scopes.some(s => s === "api" || s === "read_api");
+        const hasWriteAccess = scopes.includes("api");
+        let daysUntilExpiry = null;
+        if (data.expires_at) {
+            const [yearStr, monthStr, dayStr] = data.expires_at.split("-");
+            const year = Number(yearStr);
+            const month = Number(monthStr);
+            const day = Number(dayStr);
+            if (!Number.isNaN(year) && !Number.isNaN(month) && !Number.isNaN(day)) {
+                const expiryUtcMs = Date.UTC(year, month - 1, day);
+                const now = new Date();
+                const todayUtcMs = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+                daysUntilExpiry = Math.ceil((expiryUtcMs - todayUtcMs) / (1000 * 60 * 60 * 24));
+            }
+        }
+        const tokenType = "unknown";
+        return {
+            name: data.name,
+            scopes,
+            expiresAt: data.expires_at,
+            active: data.active && !data.revoked,
+            tokenType,
+            hasGraphQLAccess,
+            hasWriteAccess,
+            daysUntilExpiry,
+        };
+    }
+    catch (error) {
+        (0, logger_1.logDebug)("Token scope detection failed (network error)", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return null;
+    }
+}
+function isToolAvailableForScopes(toolName, scopes) {
+    const requiredScopes = TOOL_SCOPE_REQUIREMENTS[toolName];
+    if (!requiredScopes) {
+        return true;
+    }
+    return requiredScopes.some(required => scopes.includes(required));
+}
+function getToolsForScopes(scopes) {
+    return Object.keys(TOOL_SCOPE_REQUIREMENTS).filter(toolName => isToolAvailableForScopes(toolName, scopes));
+}
+function getToolScopeRequirements() {
+    return Object.fromEntries(Object.entries(TOOL_SCOPE_REQUIREMENTS).map(([toolName, scopes]) => [toolName, [...scopes]]));
+}
+function getTokenCreationUrl(baseUrl, scopes = ["api", "read_user"]) {
+    try {
+        const url = new URL(baseUrl);
+        const basePath = url.pathname === "/" ? "" : url.pathname.replace(/\/$/, "");
+        url.pathname = `${basePath}/-/user_settings/personal_access_tokens`;
+        url.searchParams.set("name", "gitlab-mcp");
+        url.searchParams.set("scopes", scopes.join(","));
+        return url.toString();
+    }
+    catch {
+        const base = baseUrl.replace(/\/$/, "");
+        const params = new URLSearchParams({
+            name: "gitlab-mcp",
+            scopes: scopes.join(","),
+        });
+        return `${base}/-/user_settings/personal_access_tokens?${params.toString()}`;
+    }
+}
+function logTokenScopeInfo(info, totalTools) {
+    const availableTools = getToolsForScopes(info.scopes);
+    const scopeList = info.scopes.join(", ");
+    if (info.daysUntilExpiry !== null && info.daysUntilExpiry <= 7) {
+        if (info.daysUntilExpiry < 0) {
+            (0, logger_1.logWarn)(`Token "${info.name}" has expired! Please create a new token.`, {
+                tokenName: info.name,
+                expiresAt: info.expiresAt,
+            });
+        }
+        else if (info.daysUntilExpiry === 0) {
+            (0, logger_1.logWarn)(`Token "${info.name}" expires today!`, {
+                tokenName: info.name,
+                expiresAt: info.expiresAt,
+            });
+        }
+        else {
+            (0, logger_1.logWarn)(`Token "${info.name}" expires in ${info.daysUntilExpiry} day(s)`, {
+                tokenName: info.name,
+                daysUntilExpiry: info.daysUntilExpiry,
+                expiresAt: info.expiresAt,
+            });
+        }
+    }
+    if (info.hasWriteAccess) {
+        (0, logger_1.logInfo)(`Token "${info.name}" detected`, {
+            tokenName: info.name,
+            scopes: scopeList,
+            expiresAt: info.expiresAt ?? "never",
+        });
+    }
+    else {
+        (0, logger_1.logInfo)(`Token "${info.name}" has limited scopes - ${availableTools.length} of ${totalTools} scope-gated tools available`, {
+            tokenName: info.name,
+            scopes: scopeList,
+            availableTools: availableTools.length,
+            totalTools,
+        });
+        if (!info.hasGraphQLAccess) {
+            (0, logger_1.logInfo)("GraphQL introspection skipped (requires 'api' or 'read_api' scope)");
+        }
+        const fixUrl = getTokenCreationUrl(config_1.GITLAB_BASE_URL);
+        (0, logger_1.logInfo)(`For full functionality, create a token with 'api' scope: ${fixUrl}`, { url: fixUrl });
+    }
+}
+//# sourceMappingURL=TokenScopeDetector.js.map

package/dist/src/services/TokenScopeDetector.js.map

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

package/dist/src/services/ToolAvailability.d.ts

@@ -0,0 +1,32 @@
+import { GitLabTier } from "./GitLabVersionDetector";
+interface ToolRequirement {
+    minVersion: string;
+    requiredTier: "free" | "premium" | "ultimate";
+    notes?: string;
+}
+interface ActionRequirement {
+    tier: "free" | "premium" | "ultimate";
+    minVersion: string;
+    notes?: string;
+}
+export declare class ToolAvailability {
+    private static readonly TIER_ORDER;
+    private static actionRequirements;
+    private static parameterRequirements;
+    static getRestrictedParameters(toolName: string, cachedInstanceInfo?: {
+        tier: GitLabTier;
+        version: string;
+    }): string[];
+    static getActionRequirement(toolName: string, action?: string): ActionRequirement | undefined;
+    static getHighestTier(toolName: string): "free" | "premium" | "ultimate";
+    static getTierRestrictedActions(toolName: string, tier: "premium" | "ultimate"): string[];
+    static isToolAvailable(toolName: string, action?: string): boolean;
+    static getAvailableTools(): string[];
+    static getToolRequirement(toolName: string, action?: string): ToolRequirement | undefined;
+    static getUnavailableReason(toolName: string, action?: string): string | null;
+    private static isTierSufficient;
+    static filterToolsByAvailability(tools: string[]): string[];
+    static getToolsByTier(tier: "free" | "premium" | "ultimate"): string[];
+    static getToolsByMinVersion(minVersion: string): string[];
+}
+export {};