@skillsmith/mcp-server 0.1.0

package/dist/src/middleware/degradation.js

@@ -0,0 +1,315 @@
+/**
+ * SMI-1060: Graceful Degradation Middleware
+ *
+ * Middleware that wraps tool handlers with graceful degradation,
+ * returning helpful messages instead of hard errors when features
+ * are unavailable.
+ */
+import { createLicenseMiddleware, getRequiredFeature, } from './license.js';
+import { TOOL_FEATURES, FEATURE_DISPLAY_NAMES, FEATURE_TIERS, } from './toolFeatureMapping.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const BASE_URL = 'https://skillsmith.io';
+/**
+ * Pricing information for each tier
+ */
+const TIER_PRICING = {
+    community: '$0/month',
+    team: '$25/user/month',
+    enterprise: '$55/user/month',
+};
+/**
+ * Feature descriptions for upgrade prompts
+ */
+const FEATURE_DESCRIPTIONS = {
+    // Team tier features
+    private_skills: 'Create and manage private skills for your organization',
+    team_workspaces: 'Collaborate with your team on shared skill collections',
+    usage_analytics: 'Track skill usage and adoption across your organization',
+    priority_support: 'Get faster response times from our support team',
+    // Enterprise tier features
+    sso_saml: 'Integrate with your identity provider for secure single sign-on',
+    rbac: 'Fine-grained access control with custom roles and permissions',
+    audit_logging: 'Comprehensive audit trail for compliance and security',
+    siem_export: 'Export audit logs to your SIEM platform for centralized monitoring',
+    compliance_reports: 'Generate compliance reports for SOC2, HIPAA, and other standards',
+    private_registry: 'Host a private registry of skills for your organization',
+    // Additional features
+    custom_integrations: 'Build custom integrations with your tools',
+    advanced_analytics: 'In-depth usage analytics and reporting',
+};
+// ============================================================================
+// Default Logger
+// ============================================================================
+/**
+ * Default no-op logger
+ */
+const noopLogger = {
+    log: () => { },
+};
+/**
+ * Console logger for degradation events
+ */
+export const consoleDegradationLogger = {
+    log: (event) => {
+        const prefix = event.action === 'degraded' ? '[UPGRADE REQUIRED]' : `[${event.action.toUpperCase()}]`;
+        console.log(`${prefix} ${event.toolName}: ${event.message || 'No message'}`);
+    },
+};
+// ============================================================================
+// Upgrade Message Generators
+// ============================================================================
+/**
+ * Create an upgrade prompt for a denied feature
+ */
+function createUpgradePrompt(feature, currentTier) {
+    const displayName = FEATURE_DISPLAY_NAMES[feature];
+    const requiredTier = FEATURE_TIERS[feature];
+    const pricing = TIER_PRICING[requiredTier];
+    return `${displayName} requires ${requiredTier.charAt(0).toUpperCase() + requiredTier.slice(1)} tier (${pricing}). Upgrade at ${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}`;
+}
+/**
+ * Create a detailed upgrade message with feature description
+ */
+function createDetailedUpgradeMessage(feature, currentTier) {
+    const displayName = FEATURE_DISPLAY_NAMES[feature];
+    const description = FEATURE_DESCRIPTIONS[feature];
+    const requiredTier = FEATURE_TIERS[feature];
+    const pricing = TIER_PRICING[requiredTier];
+    const currentPricing = TIER_PRICING[currentTier];
+    return [
+        `Feature Unavailable: ${displayName}`,
+        '',
+        description,
+        '',
+        `Current tier: ${currentTier.charAt(0).toUpperCase() + currentTier.slice(1)} (${currentPricing})`,
+        `Required tier: ${requiredTier.charAt(0).toUpperCase() + requiredTier.slice(1)} (${pricing})`,
+        '',
+        `Upgrade to unlock: ${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}`,
+        `Compare plans: ${BASE_URL}/pricing?highlight=${feature}&current=${currentTier}`,
+    ].join('\n');
+}
+/**
+ * Get tier comparison message
+ */
+export function getTierComparisonMessage() {
+    return [
+        'Skillsmith Pricing Tiers',
+        '========================',
+        '',
+        'Community ($0/month)',
+        '----------------------------------------',
+        '  - Core features: search, install, recommend, validate, compare',
+        '',
+        'Team ($25/user/month)',
+        '----------------------------------------',
+        '  - Private Skills',
+        '  - Team Workspaces',
+        '  - Priority Support',
+        '',
+        'Enterprise ($55/user/month)',
+        '----------------------------------------',
+        '  - SSO/SAML Integration',
+        '  - Role-Based Access Control',
+        '  - Audit Logging',
+        '  - Custom Integrations',
+        '  - Advanced Analytics',
+        '',
+        `Learn more: ${BASE_URL}/pricing`,
+    ].join('\n');
+}
+// ============================================================================
+// Graceful Degradation Response
+// ============================================================================
+/**
+ * Create a graceful degradation response for an unavailable feature
+ */
+function createGracefulDegradationResponse(toolName, feature, currentTier, validationResult) {
+    const requiredTier = FEATURE_TIERS[feature];
+    const displayName = FEATURE_DISPLAY_NAMES[feature];
+    const response = {
+        status: 'upgrade_required',
+        feature: {
+            id: feature,
+            name: displayName,
+            description: FEATURE_DESCRIPTIONS[feature],
+        },
+        tiers: {
+            current: {
+                id: currentTier,
+                pricing: TIER_PRICING[currentTier],
+            },
+            required: {
+                id: requiredTier,
+                pricing: TIER_PRICING[requiredTier],
+            },
+        },
+        upgrade: {
+            message: createUpgradePrompt(feature, currentTier),
+            detailedMessage: createDetailedUpgradeMessage(feature, currentTier),
+            url: `${BASE_URL}/upgrade?tier=${requiredTier}&feature=${feature}&tool=${toolName}`,
+            pricingUrl: `${BASE_URL}/pricing?highlight=${feature}&current=${currentTier}`,
+        },
+        alternatives: getCommunityAlternatives(toolName),
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response, null, 2),
+            },
+        ],
+        isError: false,
+        _meta: {
+            upgradeRequired: true,
+            feature,
+            requiredTier,
+            upgradeUrl: response.upgrade.url,
+        },
+    };
+}
+/**
+ * Get community-tier alternatives for a premium tool
+ */
+function getCommunityAlternatives(toolName) {
+    // Map of premium tools to their community alternatives
+    const alternatives = {
+        publish_private: ['search', 'get_skill', 'install_skill'],
+        team_workspace: ['search', 'install_skill'],
+        share_skill: ['search', 'skill_compare'],
+        configure_sso: ['search'],
+        audit_export: ['search'],
+        audit_query: ['search'],
+        rbac_manage: ['search'],
+        rbac_assign_role: ['search'],
+        rbac_create_policy: ['search'],
+        analytics_dashboard: ['search', 'skill_recommend'],
+        usage_report: ['search'],
+        webhook_configure: ['search'],
+        api_key_manage: ['search'],
+    };
+    return alternatives[toolName] || ['search', 'get_skill', 'install_skill'];
+}
+// ============================================================================
+// Middleware Factory
+// ============================================================================
+/**
+ * Create the degradation middleware
+ *
+ * This middleware wraps tool handlers to provide graceful degradation
+ * when features are unavailable due to license restrictions.
+ *
+ * @param options - Middleware configuration options
+ * @returns Middleware wrapper function
+ *
+ * @example
+ * ```typescript
+ * const middleware = createDegradationMiddleware({
+ *   logger: consoleDegradationLogger,
+ *   verbose: true,
+ * });
+ *
+ * const wrappedHandler = middleware.wrapHandler('audit_query', originalHandler);
+ * ```
+ */
+export function createDegradationMiddleware(options = {}) {
+    const licenseMiddleware = options.licenseMiddleware ?? createLicenseMiddleware();
+    const logger = options.logger ?? noopLogger;
+    /**
+     * Wrap a tool handler with graceful degradation
+     */
+    async function wrapHandler(toolName, handler, request) {
+        // Check if tool requires a license
+        const requiredFeature = getRequiredFeature(toolName);
+        // Community tools always pass through
+        if (requiredFeature === null) {
+            logger.log({
+                timestamp: new Date().toISOString(),
+                toolName,
+                feature: null,
+                tier: 'community',
+                action: 'allowed',
+                message: 'Community tool - no license required',
+            });
+            return handler(request);
+        }
+        // Check license for the required feature
+        const validationResult = await licenseMiddleware.checkFeature(requiredFeature);
+        if (validationResult.valid) {
+            const licenseInfo = await licenseMiddleware.getLicenseInfo();
+            logger.log({
+                timestamp: new Date().toISOString(),
+                toolName,
+                feature: requiredFeature,
+                tier: licenseInfo?.tier ?? 'community',
+                action: 'allowed',
+                message: 'Feature available in license',
+            });
+            return handler(request);
+        }
+        // Feature not available - return graceful degradation response
+        const licenseInfo = await licenseMiddleware.getLicenseInfo();
+        const currentTier = licenseInfo?.tier ?? 'community';
+        logger.log({
+            timestamp: new Date().toISOString(),
+            toolName,
+            feature: requiredFeature,
+            tier: currentTier,
+            action: 'degraded',
+            message: `Feature ${requiredFeature} requires upgrade`,
+        });
+        return createGracefulDegradationResponse(toolName, requiredFeature, currentTier, validationResult);
+    }
+    /**
+     * Create a wrapped handler function
+     */
+    function createWrappedHandler(toolName, handler) {
+        return async (request) => {
+            return wrapHandler(toolName, handler, request);
+        };
+    }
+    /**
+     * Check if a tool would be degraded for the current license
+     */
+    async function wouldDegrade(toolName) {
+        const requiredFeature = getRequiredFeature(toolName);
+        if (requiredFeature === null) {
+            return false;
+        }
+        const validationResult = await licenseMiddleware.checkFeature(requiredFeature);
+        return !validationResult.valid;
+    }
+    /**
+     * Get degradation status for all tools
+     */
+    async function getDegradationStatus() {
+        const status = new Map();
+        for (const toolName of Object.keys(TOOL_FEATURES)) {
+            status.set(toolName, await wouldDegrade(toolName));
+        }
+        return status;
+    }
+    /**
+     * Get upgrade prompt for a tool
+     */
+    async function getUpgradePrompt(toolName) {
+        const requiredFeature = getRequiredFeature(toolName);
+        if (requiredFeature === null) {
+            return null;
+        }
+        const licenseInfo = await licenseMiddleware.getLicenseInfo();
+        const currentTier = licenseInfo?.tier ?? 'community';
+        return createUpgradePrompt(requiredFeature, currentTier);
+    }
+    return {
+        wrapHandler,
+        createWrappedHandler,
+        wouldDegrade,
+        getDegradationStatus,
+        getUpgradePrompt,
+        getTierComparisonMessage,
+        licenseMiddleware,
+    };
+}
+//# sourceMappingURL=degradation.js.map

package/dist/src/middleware/degradation.js.map

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

package/dist/src/middleware/errorFormatter.d.ts

@@ -0,0 +1,119 @@
+/**
+ * SMI-1061: MCP Error Formatter for License Errors
+ *
+ * Formats license errors into MCP protocol-compliant error responses
+ * with actionable information for clients.
+ */
+/**
+ * MCP-formatted error response content
+ */
+export interface MCPErrorContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * MCP-formatted error response
+ */
+export interface MCPErrorResponse {
+    content: MCPErrorContent[];
+    isError: true;
+    _meta?: {
+        upgradeUrl?: string;
+        errorCode?: string;
+        recoverable?: boolean;
+    };
+}
+/**
+ * License error details structure (mirrors the enterprise package)
+ */
+export interface LicenseErrorDetails {
+    code: string;
+    message: string;
+    feature?: string;
+    currentTier?: string;
+    requiredTier?: string;
+    upgradeUrl?: string;
+    context?: Record<string, unknown>;
+    timestamp?: string;
+}
+/**
+ * Interface for license errors (duck-typed for optional enterprise package)
+ */
+export interface LicenseErrorLike {
+    code?: string;
+    message: string;
+    feature?: string;
+    currentTier?: string;
+    requiredTier?: string;
+    upgradeUrl?: string;
+    context?: Record<string, unknown>;
+    timestamp?: Date;
+    toJSON?: () => Record<string, unknown>;
+}
+/**
+ * Format a license error into an MCP-compliant error response
+ *
+ * @param error - The license error to format
+ * @returns MCP-formatted error response
+ *
+ * @example
+ * ```typescript
+ * import { formatLicenseError } from './middleware/errorFormatter.js';
+ *
+ * try {
+ *   await checkFeature('audit_logging');
+ * } catch (error) {
+ *   if (isLicenseError(error)) {
+ *     return formatLicenseError(error);
+ *   }
+ *   throw error;
+ * }
+ * ```
+ */
+export declare function formatLicenseError(error: LicenseErrorLike): MCPErrorResponse;
+/**
+ * Format a generic error for MCP response
+ *
+ * Use this for non-license errors that still need MCP formatting.
+ */
+export declare function formatGenericError(error: Error, code?: string): MCPErrorResponse;
+/**
+ * Get a user-friendly message for an error code
+ */
+export declare function getUserFriendlyMessage(code: string): string;
+/**
+ * Configuration for upgrade URLs
+ */
+export interface UpgradeUrlConfig {
+    baseUrl?: string;
+    includeFeature?: boolean;
+    includeTiers?: boolean;
+    includeSource?: boolean;
+}
+/**
+ * Generate a customized upgrade URL with tracking parameters
+ */
+export declare function generateUpgradeUrl(error: LicenseErrorLike, config?: Partial<UpgradeUrlConfig>): string;
+/**
+ * Build an upgrade required response
+ *
+ * Use this when a feature requires an upgrade but isn't a full error.
+ */
+export declare function buildUpgradeRequiredResponse(feature: string, currentTier: string, requiredTier: string): MCPErrorResponse;
+/**
+ * Build a license expired response with renewal URL
+ */
+export declare function buildLicenseExpiredResponse(expiredAt?: Date): MCPErrorResponse;
+/**
+ * Build a quota exceeded response
+ */
+export declare function buildQuotaExceededResponse(quotaType: string, current: number, max: number): MCPErrorResponse;
+/**
+ * Check if an object looks like a license error
+ */
+export declare function isLicenseErrorLike(error: unknown): error is LicenseErrorLike;
+/**
+ * Safely convert any error to MCP format
+ */
+export declare function safeFormatError(error: unknown): MCPErrorResponse;
+//# sourceMappingURL=errorFormatter.d.ts.map

package/dist/src/middleware/errorFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorFormatter.d.ts","sourceRoot":"","sources":["../../../src/middleware/errorFormatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,WAAW,CAAC,EAAE,OAAO,CAAA;KACtB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAsD5E;AAYD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,SAAmB,GAAG,gBAAgB,CAmB1F;AAsBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AASD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,gBAAgB,EACvB,MAAM,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACrC,MAAM,CA0BR;AAMD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAgClB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,CAAC,EAAE,IAAI,GAAG,gBAAgB,CA8B9E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,gBAAgB,CAgClB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAiB5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAUhE"}