@supermodeltools/mcp-server 0.7.1 → 0.7.2

package/dist/utils/github.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Shared utilities for GitHub API interactions.
+ * Used by feedback tools (request_feature, report_bug) to create issues.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_FETCH_TIMEOUT_MS = exports.GITHUB_API_URL = exports.GITHUB_REPO = void 0;
+exports.validateGitHubToken = validateGitHubToken;
+exports.validateRequiredString = validateRequiredString;
+exports.validateOptionalString = validateOptionalString;
+exports.validateLabels = validateLabels;
+exports.classifyGitHubHttpError = classifyGitHubHttpError;
+exports.createGitHubIssue = createGitHubIssue;
+const types_1 = require("../types");
+const logger = __importStar(require("./logger"));
+exports.GITHUB_REPO = 'supermodeltools/mcp';
+exports.GITHUB_API_URL = `https://api.github.com/repos/${exports.GITHUB_REPO}/issues`;
+exports.GITHUB_FETCH_TIMEOUT_MS = 15_000;
+/**
+ * Validate that GITHUB_TOKEN is set. Returns a StructuredError if not.
+ */
+function validateGitHubToken() {
+    if (!process.env.GITHUB_TOKEN) {
+        return {
+            type: 'authentication_error',
+            message: 'GITHUB_TOKEN environment variable is not set.',
+            code: 'MISSING_GITHUB_TOKEN',
+            recoverable: false,
+            suggestion: 'Set the GITHUB_TOKEN environment variable with a token that has repo scope, then restart the MCP server.',
+        };
+    }
+    return null;
+}
+/**
+ * Validate a required string parameter.
+ * Returns a StructuredError if invalid, null if valid.
+ */
+function validateRequiredString(value, paramName, code, suggestion) {
+    if (!value || typeof value !== 'string') {
+        return {
+            type: 'validation_error',
+            message: `Missing or invalid "${paramName}" parameter. Must be a non-empty string.`,
+            code,
+            recoverable: false,
+            suggestion,
+        };
+    }
+    return null;
+}
+/**
+ * Validate an optional string parameter.
+ * Returns a StructuredError if present but invalid, null otherwise.
+ */
+function validateOptionalString(value, paramName, code, suggestion) {
+    if (value !== undefined && (typeof value !== 'string' || value === '')) {
+        return {
+            type: 'validation_error',
+            message: `Invalid "${paramName}" parameter. Must be a non-empty string if provided.`,
+            code,
+            recoverable: false,
+            suggestion,
+        };
+    }
+    return null;
+}
+/**
+ * Validate an optional labels array.
+ * Returns a StructuredError if invalid, null if valid.
+ */
+function validateLabels(labels) {
+    if (labels === undefined)
+        return null;
+    if (!Array.isArray(labels)) {
+        return {
+            type: 'validation_error',
+            message: 'Invalid "labels" parameter. Must be an array of strings.',
+            code: 'INVALID_LABELS',
+            recoverable: false,
+            suggestion: 'Provide labels as an array of strings, e.g. ["enhancement", "good first issue"].',
+        };
+    }
+    if (!labels.every((l) => typeof l === 'string')) {
+        return {
+            type: 'validation_error',
+            message: 'Invalid "labels" parameter. All items must be strings.',
+            code: 'INVALID_LABELS',
+            recoverable: false,
+            suggestion: 'Provide labels as an array of strings, e.g. ["enhancement", "good first issue"].',
+        };
+    }
+    return null;
+}
+/**
+ * Classify a GitHub API HTTP error response into a StructuredError.
+ */
+function classifyGitHubHttpError(status, errorBody) {
+    switch (status) {
+        case 401:
+            return {
+                type: 'authentication_error',
+                message: 'GitHub token is invalid or expired.',
+                code: 'INVALID_GITHUB_TOKEN',
+                recoverable: false,
+                suggestion: 'Check that GITHUB_TOKEN is valid and has not expired.',
+            };
+        case 403:
+            return {
+                type: 'authorization_error',
+                message: 'GitHub token does not have permission to create issues.',
+                code: 'GITHUB_FORBIDDEN',
+                recoverable: false,
+                suggestion: 'Ensure the GITHUB_TOKEN has "repo" or "public_repo" scope.',
+            };
+        case 404:
+            return {
+                type: 'not_found_error',
+                message: `Repository ${exports.GITHUB_REPO} not found or not accessible.`,
+                code: 'REPO_NOT_FOUND',
+                recoverable: false,
+                suggestion: 'Check that the GitHub token has access to the repository.',
+            };
+        case 422:
+            return {
+                type: 'validation_error',
+                message: `GitHub rejected the issue: ${errorBody}`,
+                code: 'GITHUB_VALIDATION_ERROR',
+                recoverable: false,
+                suggestion: 'Check the title and description for invalid content.',
+            };
+        case 429:
+            return {
+                type: 'rate_limit_error',
+                message: 'GitHub API rate limit exceeded.',
+                code: 'GITHUB_RATE_LIMITED',
+                recoverable: true,
+                suggestion: 'Wait a few minutes and retry.',
+            };
+        default:
+            return {
+                type: 'internal_error',
+                message: `GitHub API returned HTTP ${status}: ${errorBody}`,
+                code: 'GITHUB_API_ERROR',
+                recoverable: status >= 500,
+                suggestion: status >= 500
+                    ? 'GitHub may be experiencing issues. Wait and retry.'
+                    : 'Check the request parameters.',
+            };
+    }
+}
+/**
+ * Create a GitHub issue via the API.
+ * Handles authentication, HTTP errors, and network failures.
+ *
+ * @param toolName - Name of the calling tool (for logging)
+ * @param payload - The issue title, body, and optional labels
+ * @param successMessage - Message to include in the success response
+ * @returns ToolCallResult with success data or structured error
+ */
+async function createGitHubIssue(toolName, payload, successMessage) {
+    const token = process.env.GITHUB_TOKEN;
+    // Token was already validated by the caller, but guard anyway
+    if (!token) {
+        return (0, types_1.asErrorResult)({
+            type: 'authentication_error',
+            message: 'GITHUB_TOKEN environment variable is not set.',
+            code: 'MISSING_GITHUB_TOKEN',
+            recoverable: false,
+            suggestion: 'Set the GITHUB_TOKEN environment variable with a token that has repo scope, then restart the MCP server.',
+        });
+    }
+    const body = {
+        title: payload.title,
+        body: payload.body,
+    };
+    if (payload.labels && payload.labels.length > 0) {
+        body.labels = payload.labels;
+    }
+    logger.debug(`[${toolName}] Creating issue:`, payload.title);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), exports.GITHUB_FETCH_TIMEOUT_MS);
+    try {
+        const response = await fetch(exports.GITHUB_API_URL, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Accept': 'application/vnd.github+json',
+                'Content-Type': 'application/json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+            signal: controller.signal,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const errorBody = await response.text();
+            logger.error(`[${toolName}] GitHub API error:`, response.status, errorBody);
+            return (0, types_1.asErrorResult)(classifyGitHubHttpError(response.status, errorBody));
+        }
+        const issue = await response.json();
+        logger.debug(`[${toolName}] Issue created:`, issue.html_url);
+        return (0, types_1.asTextContentResult)({
+            message: successMessage,
+            issue_url: issue.html_url,
+            issue_number: issue.number,
+            title: issue.title,
+        });
+    }
+    catch (error) {
+        logger.error(`[${toolName}] Network error:`, error.message);
+        return (0, types_1.asErrorResult)({
+            type: 'network_error',
+            message: `Failed to reach GitHub API: ${error.message}`,
+            code: 'GITHUB_NETWORK_ERROR',
+            recoverable: true,
+            suggestion: 'Check network connectivity and retry.',
+        });
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supermodeltools/mcp-server",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "MCP server for Supermodel API - code graph generation for AI agents",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -38,7 +38,7 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.1",
-    "@supermodeltools/sdk": "0.7.1",
+    "@supermodeltools/sdk": "0.7.2",
     "archiver": "^7.0.1",
     "ignore": "^7.0.5",
     "jq-web": "^0.6.2",