@zereight/mcp-gitlab 2.3.8-next.145 → 2.3.8-next.147

package/build/utils/error-hints.js

@@ -0,0 +1,42 @@
+const NEXT_PREFIX = "\nNext: ";
+export function hasRecoveryHint(message) {
+    return message.includes(NEXT_PREFIX);
+}
+export function recoveryHintFor(message) {
+    if (/^Access denied:/i.test(message)) {
+        return undefined;
+    }
+    if (/is not available on this server/i.test(message)) {
+        if (/slim tool profile/i.test(message) || /cannot activate/i.test(message)) {
+            return undefined;
+        }
+        if (/discover_tools|GITLAB_TOOLSETS|GITLAB_TOOLS/.test(message)) {
+            return "call discover_tools with the category, or add it to GITLAB_TOOLSETS.";
+        }
+    }
+    if (/\b401\b/.test(message) || /unauthorized/i.test(message)) {
+        return "set GITLAB_PERSONAL_ACCESS_TOKEN (or run `zereight-mcp-gitlab auth`) and retry.";
+    }
+    if (/rate limit/i.test(message)) {
+        return "wait and retry; lower per_page or paginate if the client is bursting.";
+    }
+    if (/\b403\b/.test(message) ||
+        /forbidden/i.test(message) ||
+        /insufficient_scope/i.test(message)) {
+        return "check token scopes and GITLAB_PERMISSION_MODE; grant read_user or User:Read for whoami.";
+    }
+    if (/\b404\b/.test(message) || /404 not found/i.test(message)) {
+        return "check project_id (numeric ID or group%2Fproject) and the resource iid.";
+    }
+    return undefined;
+}
+export function appendRecoveryHint(message) {
+    if (hasRecoveryHint(message)) {
+        return message;
+    }
+    const hint = recoveryHintFor(message);
+    if (hint === undefined) {
+        return message;
+    }
+    return `${message}${NEXT_PREFIX}${hint}`;
+}

package/build/utils/list-summary.js

@@ -0,0 +1,90 @@
+/** MCP-only argument; stripped before GitLab handlers run. */
+export const LIST_SUMMARY_ARGUMENT = "summary";
+export const LIST_SUMMARY_ARGUMENT_DESCRIPTION = "If true, return only high-signal fields (id, iid, title, state, web_url, …). Default false keeps the full GitLab JSON.";
+const SUMMARY_FIELDS = [
+    "id",
+    "iid",
+    "title",
+    "name",
+    "state",
+    "status",
+    "ref",
+    "web_url",
+    "path_with_namespace",
+    "username",
+    "short_id",
+    "key",
+    "tag_name",
+    "slug",
+    "filename",
+    "new_path",
+];
+const NATIVE_SUMMARY_TOOLS = new Set(["list_webhook_events"]);
+export function toolAcceptsDecoratedSummary(toolName) {
+    if (NATIVE_SUMMARY_TOOLS.has(toolName)) {
+        return false;
+    }
+    return toolName.startsWith("list_") || toolName === "mr_discussions";
+}
+export function readListSummaryRequested(args) {
+    if (!args) {
+        return false;
+    }
+    const raw = args[LIST_SUMMARY_ARGUMENT];
+    return raw === true || raw === "true";
+}
+export function omitListSummaryArgument(args) {
+    if (!(LIST_SUMMARY_ARGUMENT in args)) {
+        return args;
+    }
+    const { [LIST_SUMMARY_ARGUMENT]: _omit, ...rest } = args;
+    return rest;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function summarizeItem(item) {
+    if (!isRecord(item)) {
+        return item;
+    }
+    const summarized = {};
+    for (const field of SUMMARY_FIELDS) {
+        if (field in item) {
+            summarized[field] = item[field];
+        }
+    }
+    return Object.keys(summarized).length > 0 ? summarized : item;
+}
+export function summarizeListPayload(data) {
+    if (Array.isArray(data)) {
+        return data.map(summarizeItem);
+    }
+    if (isRecord(data) && Array.isArray(data.items)) {
+        return { ...data, items: data.items.map(summarizeItem) };
+    }
+    return data;
+}
+function isTextContentBlock(value) {
+    return typeof value === "object" && value !== null;
+}
+export function applyListSummaryToToolResult(result, requested) {
+    if (!requested || result.isError) {
+        return result;
+    }
+    if (!Array.isArray(result.content)) {
+        return result;
+    }
+    const content = result.content.map(block => {
+        if (!isTextContentBlock(block) || block.type !== "text" || typeof block.text !== "string") {
+            return block;
+        }
+        try {
+            const parsed = JSON.parse(block.text);
+            return { ...block, text: JSON.stringify(summarizeListPayload(parsed)) };
+        }
+        catch {
+            return block;
+        }
+    });
+    return { ...result, content };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zereight/mcp-gitlab",
-  "version": "2.3.8-next.145",
+  "version": "2.3.8-next.147",
   "mcpName": "io.github.zereight/gitlab-mcp",
   "description": "GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more",
   "keywords": [