@elliotding/ai-agent-mcp 0.1.0

package/dist/tools/upload-resource.js

@@ -0,0 +1,252 @@
+"use strict";
+/**
+ * upload_resource Tool
+ *
+ * Uploads resource files to a CSP source repository via the two-step API:
+ *   Step 1: POST /csp/api/resources/upload  → returns upload_id (server-side staging)
+ *   Step 2: POST /csp/api/resources/finalize → triggers Git commit, returns permanent resource_id
+ *
+ * The user selects files from anywhere on their local machine. The AI reads the file
+ * content and passes it directly in files[]. The MCP server forwards everything to the
+ * CSP API — no local path resolution or server-side filesystem access is needed.
+ *
+ * target_source is passed through to the CSP API as-is; the CSP server decides
+ * which Git repo to commit to based on that value.
+ */
+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.uploadResourceTool = void 0;
+exports.uploadResource = uploadResource;
+const path = __importStar(require("path"));
+const logger_1 = require("../utils/logger");
+const client_1 = require("../api/client");
+const resources_1 = require("../resources");
+const errors_1 = require("../types/errors");
+/**
+ * Validate and return the files[] array.
+ * Each entry path must be a relative path with no traversal.
+ * For MCP resources, mcp-config.json must be present.
+ */
+function collectFiles(typedParams) {
+    if (!typedParams.files || typedParams.files.length === 0) {
+        throw (0, errors_1.createValidationError)('files', 'required', '"files" must be a non-empty array of {path, content} entries.');
+    }
+    for (const entry of typedParams.files) {
+        const norm = path.normalize(entry.path);
+        if (norm.startsWith('..') || path.isAbsolute(norm)) {
+            throw (0, errors_1.createValidationError)('files[].path', 'relative_path', `Path traversal or absolute path not allowed: "${entry.path}"`);
+        }
+    }
+    // MCP resources must include mcp-config.json so the client can auto-register
+    // the server in ~/.cursor/mcp.json after sync_resources installs it.
+    if (typedParams.type === 'mcp') {
+        const hasMcpConfig = typedParams.files.some((f) => path.basename(f.path) === 'mcp-config.json');
+        if (!hasMcpConfig) {
+            throw (0, errors_1.createValidationError)('files', 'required', 'MCP resources must include a "mcp-config.json" file. ' +
+                'This file tells the client how to start the MCP server after installation. ' +
+                'Required format:\n' +
+                '{\n' +
+                '  "name": "<server-name>",\n' +
+                '  "command": "python3",          // or "node", "uvx", etc.\n' +
+                '  "args": ["<entry-file.py>"],   // relative path resolved against install dir\n' +
+                '  "env": { "ENV_VAR": "" }       // optional; empty string = user must fill in\n' +
+                '}');
+        }
+    }
+    return typedParams.files;
+}
+async function uploadResource(params) {
+    const startTime = Date.now();
+    const typedParams = params;
+    logger_1.logger.info({ tool: 'upload_resource', params }, 'upload_resource called');
+    try {
+        const resourceType = typedParams.type;
+        const resourceId = typedParams.resource_id;
+        const resourceName = typedParams.name ?? resourceId; // API uses "name" field
+        const targetSource = typedParams.target_source ?? 'csp'; // default to "csp" repo
+        const force = typedParams.force || false;
+        logger_1.logger.info({ resourceId, resourceType, targetSource }, 'Upload target resolved');
+        // ========== Step 1: Duplicate-name check ==========
+        try {
+            if (!resources_1.resourceLoader.getStats()) {
+                await resources_1.resourceLoader.loadConfig();
+                await resources_1.resourceLoader.scanResources();
+            }
+            const existing = resources_1.resourceLoader.searchResourcesByName(resourceName, resourceType);
+            if (existing.length > 0 && !force) {
+                const conflictInfo = existing.map((r) => ({ name: r.name, type: r.type, source: r.source }));
+                logger_1.logger.warn({ resourceName, resourceType, conflictInfo }, 'Resource name conflict detected');
+                return {
+                    success: false,
+                    error: {
+                        code: 'RESOURCE_NAME_CONFLICT',
+                        message: `Resource "${resourceName}" already exists. Add "force": true to overwrite.\n` +
+                            conflictInfo.map((c) => `  - ${c.name} (${c.type}, source: ${c.source})`).join('\n'),
+                        details: conflictInfo,
+                    },
+                };
+            }
+        }
+        catch (err) {
+            logger_1.logger.warn({ error: err.message }, 'Duplicate check failed, continuing upload');
+        }
+        // ========== Step 3: Validate commit message ==========
+        if (!typedParams.message || typeof typedParams.message !== 'string') {
+            throw (0, errors_1.createValidationError)('message', 'string', 'Commit message is required');
+        }
+        if (typedParams.message.length < 5 || typedParams.message.length > 200) {
+            throw (0, errors_1.createValidationError)('message', 'string', `Commit message must be 5-200 characters, got ${typedParams.message.length}`);
+        }
+        // ========== Step 4: Collect files ==========
+        const fileEntries = collectFiles(typedParams);
+        logger_1.logger.info({ resourceId, fileCount: fileEntries.length }, 'Files collected for upload');
+        // ========== Step 5: Call CSP API — upload (staging) ==========
+        logger_1.logger.info({ resourceName, resourceType, targetSource }, 'Calling CSP upload API...');
+        const uploadResp = await client_1.apiClient.uploadResourceFiles({
+            type: resourceType,
+            name: resourceName,
+            files: fileEntries,
+            target_source: targetSource,
+            force,
+        });
+        const uploadId = uploadResp.upload_id;
+        logger_1.logger.info({ uploadId, expiresAt: uploadResp.expires_at }, 'Upload staged successfully');
+        // ========== Step 6: Call CSP API — finalize (Git commit) ==========
+        logger_1.logger.info({ uploadId }, 'Calling CSP finalize API...');
+        const finalizeResp = await client_1.apiClient.finalizeResourceUpload(uploadId, typedParams.message);
+        const finalResourceId = finalizeResp.resource_id;
+        const version = finalizeResp.version ?? '1.0.0';
+        const resourceUrl = finalizeResp.url ?? '';
+        const commitHash = finalizeResp.commit_hash ?? '';
+        logger_1.logger.info({ finalResourceId, version, commitHash }, 'Upload finalized successfully');
+        const result = {
+            resource_id: finalResourceId,
+            version,
+            url: resourceUrl,
+            commit_hash: commitHash,
+            message: `Resource '${resourceName}' (${resourceType}) uploaded to source '${targetSource}' (v${version}). ${resourceUrl ? `URL: ${resourceUrl}` : ''}`.trim(),
+        };
+        const duration = Date.now() - startTime;
+        (0, logger_1.logToolCall)('upload_resource', 'user-id', params, duration);
+        logger_1.logger.info({ finalResourceId, version, source: targetSource, duration }, 'upload_resource completed');
+        return { success: true, data: result };
+    }
+    catch (error) {
+        logger_1.logger.error({ error, resourceId: typedParams.resource_id }, 'upload_resource failed');
+        return {
+            success: false,
+            error: {
+                code: error instanceof errors_1.MCPServerError ? error.code : 'UNKNOWN_ERROR',
+                message: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+}
+// Tool definition for registry
+exports.uploadResourceTool = {
+    name: 'upload_resource',
+    description: 'Upload a new AI resource (command, skill, rule, or mcp) to a CSP source repository. ' +
+        'The user selects files from anywhere on their local machine — read each file and pass its content in files[]. ' +
+        'ALWAYS confirm two things with the user before uploading: ' +
+        '(1) the resource type (command/skill/rule/mcp), and ' +
+        '(2) the target source repo (e.g. "csp" (default) or "client-sdk-ai-hub"). ' +
+        'The tool uses a two-step CSP API: first stages files and gets an upload_id, then finalizes the Git commit. ' +
+        'Pass files[] — an array of {path, content} entries. ' +
+        'path is the filename the resource should be stored as (e.g. "csp-ai-agent.mdc", "SKILL.md"). ' +
+        'Single-file upload: one entry in files[]. Multi-file upload: multiple entries. ' +
+        'No restriction on file extensions — mcp packages may include .py, .js, package.json, etc.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            resource_id: {
+                type: 'string',
+                description: 'Unique resource identifier used as commit label and for duplicate detection',
+            },
+            name: {
+                type: 'string',
+                description: 'Human-readable resource name sent to the CSP API (defaults to resource_id if omitted)',
+            },
+            type: {
+                type: 'string',
+                enum: ['command', 'skill', 'rule', 'mcp'],
+                description: 'Resource category — MUST be confirmed with the user. ' +
+                    'command: single .md slash-command file; ' +
+                    'skill: directory with SKILL.md + supporting files; ' +
+                    'rule: single .mdc Cursor rule file; ' +
+                    'mcp: MCP server package — MUST include mcp-config.json (defines command/args/env for auto-registration into ~/.cursor/mcp.json).',
+            },
+            message: {
+                type: 'string',
+                description: 'Git commit message (5-200 characters)',
+            },
+            target_source: {
+                type: 'string',
+                description: 'Target source repo name on the CSP server. ' +
+                    'Ask the user which repo to target. Typical values: "csp" (default), "client-sdk-ai-hub". ' +
+                    'The CSP server will commit the resource to the corresponding Git repo.',
+            },
+            files: {
+                type: 'array',
+                description: 'List of files to upload. Read each file from the user\'s local machine and pass content here. ' +
+                    'path is the filename the resource should be stored as on the server. ' +
+                    'Examples (type="rule"): [{path: "csp-ai-agent.mdc", content: "..."}]. ' +
+                    'Examples (type="skill"): [{path: "SKILL.md", content: "..."}, {path: "examples.md", content: "..."}]. ' +
+                    'Examples (type="mcp"): [{path: "server.py", content: "..."}, {path: "mcp-config.json", content: "..."}]. ' +
+                    'No restriction on file extension.',
+                items: {
+                    type: 'object',
+                    properties: {
+                        path: { type: 'string', description: 'Relative path under the type subdirectory' },
+                        content: { type: 'string', description: 'Full text content of the file' },
+                    },
+                    required: ['path', 'content'],
+                },
+            },
+            team: {
+                type: 'string',
+                description: 'Team / group name (defaults to Client-Public)',
+                default: 'Client-Public',
+            },
+            force: {
+                type: 'boolean',
+                description: 'Overwrite if a resource with the same name already exists',
+                default: false,
+            },
+        },
+        required: ['resource_id', 'type', 'message', 'files'],
+    },
+    handler: uploadResource,
+};
+//# sourceMappingURL=upload-resource.js.map

package/dist/tools/upload-resource.js.map

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

package/dist/transport/sse.d.ts

@@ -0,0 +1,29 @@
+/**
+ * SSE Transport Implementation
+ * MCP protocol over Server-Sent Events
+ */
+export interface SSEMessage {
+    jsonrpc: '2.0';
+    id?: string | number;
+    method?: string;
+    params?: unknown;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export declare class SSETransport {
+    constructor();
+    /**
+     * Handle incoming message from client
+     */
+    handleMessage(sessionId: string, message: SSEMessage): Promise<void>;
+    /**
+     * Send message to client via SSE
+     */
+    private sendMessage;
+}
+export declare const sseTransport: SSETransport;
+//# sourceMappingURL=sse.d.ts.map

package/dist/transport/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/transport/sse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,qBAAa,YAAY;;IAKvB;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAwQ1E;;OAEG;IACH,OAAO,CAAC,WAAW;CAMpB;AAGD,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/transport/sse.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * SSE Transport Implementation
+ * MCP protocol over Server-Sent Events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sseTransport = exports.SSETransport = void 0;
+const logger_1 = require("../utils/logger");
+const manager_1 = require("../session/manager");
+const registry_1 = require("../tools/registry");
+const middleware_1 = require("../auth/middleware");
+class SSETransport {
+    constructor() {
+        logger_1.logger.info('SSE transport initialized');
+    }
+    /**
+     * Handle incoming message from client
+     */
+    async handleMessage(sessionId, message) {
+        const messageStartTime = Date.now();
+        logger_1.logger.info({
+            type: 'sse_message_received',
+            sessionId,
+            method: message.method,
+            messageId: message.id,
+            hasParams: !!message.params,
+            timestamp: new Date().toISOString()
+        }, `SSE message received: ${message.method}`);
+        try {
+            // Validate session
+            (0, logger_1.logToolStep)('sse', 'Validating session', { sessionId });
+            const session = manager_1.sessionManager.getSession(sessionId);
+            if (!session) {
+                logger_1.logger.error({
+                    type: 'sse_error',
+                    sessionId,
+                    method: message.method,
+                    error: 'session_not_found',
+                    timestamp: new Date().toISOString()
+                }, 'Session not found or expired');
+                throw new Error('Session not found or expired');
+            }
+            logger_1.logger.debug({
+                type: 'sse_session_validated',
+                sessionId,
+                userId: session.userId,
+                email: session.email,
+                groups: session.groups,
+                timestamp: new Date().toISOString()
+            }, 'Session validated');
+            // Update session activity
+            manager_1.sessionManager.updateActivity(sessionId);
+            (0, logger_1.logToolStep)('sse', 'Session activity updated', { sessionId });
+            // Handle MCP message
+            if (message.method === 'tools/list') {
+                (0, logger_1.logToolStep)('sse', 'Handling tools/list request', { sessionId });
+                const tools = registry_1.toolRegistry.getMCPToolDefinitions();
+                logger_1.logger.info({
+                    type: 'sse_tools_list',
+                    sessionId,
+                    toolCount: tools.length,
+                    toolNames: tools.map(t => t.name),
+                    timestamp: new Date().toISOString()
+                }, `Returning ${tools.length} tool definitions`);
+                const response = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: { tools },
+                };
+                this.sendMessage(sessionId, response);
+            }
+            else if (message.method === 'tools/call') {
+                const params = message.params;
+                const toolName = params.name;
+                const args = params.arguments || {};
+                logger_1.logger.info({
+                    type: 'sse_tool_call',
+                    sessionId,
+                    toolName,
+                    userId: session.userId,
+                    email: session.email,
+                    argsPreview: JSON.stringify(args).substring(0, 200),
+                    timestamp: new Date().toISOString()
+                }, `Executing tool: ${toolName}`);
+                (0, logger_1.logToolStep)(toolName, 'Tool call initiated via SSE', {
+                    sessionId,
+                    userId: session.userId,
+                    email: session.email
+                });
+                try {
+                    // Check permissions if user is authenticated
+                    if (session.userId && session.groups && session.groups.length > 0) {
+                        (0, logger_1.logToolStep)(toolName, 'Checking tool permissions', {
+                            userId: session.userId,
+                            email: session.email,
+                            groups: session.groups
+                        });
+                        const permissionStartTime = Date.now();
+                        const permissionCheck = (0, middleware_1.checkToolCallPermission)(toolName, {
+                            userId: session.userId,
+                            email: session.email,
+                            groups: session.groups,
+                        });
+                        const permissionDuration = Date.now() - permissionStartTime;
+                        if (!permissionCheck.allowed) {
+                            logger_1.logger.warn({
+                                type: 'sse_permission_denied',
+                                sessionId,
+                                userId: session.userId,
+                                email: session.email,
+                                groups: session.groups,
+                                toolName,
+                                reason: permissionCheck.reason,
+                                duration: permissionDuration,
+                                timestamp: new Date().toISOString()
+                            }, `Tool call permission denied for ${toolName}`);
+                            const errorResponse = {
+                                jsonrpc: '2.0',
+                                id: message.id,
+                                error: {
+                                    code: -32600, // Invalid Request
+                                    message: permissionCheck.reason || 'Permission denied',
+                                },
+                            };
+                            this.sendMessage(sessionId, errorResponse);
+                            return;
+                        }
+                        logger_1.logger.debug({
+                            type: 'sse_permission_granted',
+                            sessionId,
+                            userId: session.userId,
+                            toolName,
+                            duration: permissionDuration,
+                            timestamp: new Date().toISOString()
+                        }, `Permission granted for ${toolName}`);
+                    }
+                    (0, logger_1.logToolStep)(toolName, 'Executing tool handler', { args });
+                    const toolStartTime = Date.now();
+                    const result = await registry_1.toolRegistry.callTool(toolName, args);
+                    const toolDuration = Date.now() - toolStartTime;
+                    // Log complete result
+                    logger_1.logger.info({
+                        type: 'sse_tool_success',
+                        sessionId,
+                        toolName,
+                        userId: session.userId,
+                        resultType: typeof result,
+                        resultPreview: JSON.stringify(result).substring(0, 500),
+                        duration: toolDuration,
+                        timestamp: new Date().toISOString()
+                    }, `Tool ${toolName} executed successfully`);
+                    (0, logger_1.logToolStep)(toolName, 'Tool execution completed', {
+                        duration: toolDuration,
+                        resultSize: JSON.stringify(result).length
+                    });
+                    const response = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        result,
+                    };
+                    this.sendMessage(sessionId, response);
+                }
+                catch (error) {
+                    const toolDuration = Date.now() - messageStartTime;
+                    logger_1.logger.error({
+                        type: 'sse_tool_error',
+                        sessionId,
+                        toolName,
+                        userId: session.userId,
+                        error: error instanceof Error ? {
+                            message: error.message,
+                            stack: error.stack,
+                            name: error.name
+                        } : String(error),
+                        duration: toolDuration,
+                        timestamp: new Date().toISOString()
+                    }, `Tool ${toolName} execution failed`);
+                    const errorResponse = {
+                        jsonrpc: '2.0',
+                        id: message.id,
+                        error: {
+                            code: -32603,
+                            message: error instanceof Error ? error.message : 'Tool execution failed',
+                            data: error,
+                        },
+                    };
+                    this.sendMessage(sessionId, errorResponse);
+                }
+            }
+            else if (message.method === 'initialize') {
+                logger_1.logger.info({
+                    type: 'sse_initialize',
+                    sessionId,
+                    timestamp: new Date().toISOString()
+                }, 'Client initialization request');
+                const response = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: {
+                            tools: {},
+                        },
+                        serverInfo: {
+                            name: 'csp-ai-agent-mcp',
+                            version: '0.2.0',
+                        },
+                    },
+                };
+                this.sendMessage(sessionId, response);
+            }
+            else if (message.method === 'ping') {
+                // Keepalive ping
+                logger_1.logger.debug({
+                    type: 'sse_ping',
+                    sessionId,
+                    timestamp: new Date().toISOString()
+                }, 'Keepalive ping received');
+                const response = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    result: { type: 'pong' },
+                };
+                this.sendMessage(sessionId, response);
+            }
+            else {
+                // Unknown method
+                logger_1.logger.warn({
+                    type: 'sse_unknown_method',
+                    sessionId,
+                    method: message.method,
+                    timestamp: new Date().toISOString()
+                }, `Unknown method: ${message.method}`);
+                const errorResponse = {
+                    jsonrpc: '2.0',
+                    id: message.id,
+                    error: {
+                        code: -32601,
+                        message: `Method not found: ${message.method}`,
+                    },
+                };
+                this.sendMessage(sessionId, errorResponse);
+            }
+        }
+        catch (error) {
+            logger_1.logger.error({ error, sessionId }, 'Error handling message');
+            const errorResponse = {
+                jsonrpc: '2.0',
+                id: message.id,
+                error: {
+                    code: -32603,
+                    message: error instanceof Error ? error.message : 'Internal error',
+                },
+            };
+            this.sendMessage(sessionId, errorResponse);
+        }
+    }
+    /**
+     * Send message to client via SSE
+     */
+    sendMessage(sessionId, message) {
+        const sent = manager_1.sessionManager.sendMessage(sessionId, message);
+        if (!sent) {
+            logger_1.logger.warn({ sessionId, messageId: message.id }, 'Failed to send message to client');
+        }
+    }
+}
+exports.SSETransport = SSETransport;
+// Singleton instance
+exports.sseTransport = new SSETransport();
+//# sourceMappingURL=sse.js.map

package/dist/transport/sse.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Custom Error Types
+ * Typed errors for different failure scenarios
+ */
+/**
+ * Base Error for MCP Server operations
+ */
+export declare class MCPServerError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: string, details?: unknown | undefined);
+}
+/**
+ * Git Operation Error
+ */
+export declare class GitError extends MCPServerError {
+    readonly operation: string;
+    readonly repositoryUrl?: string | undefined;
+    constructor(message: string, operation: string, repositoryUrl?: string | undefined, details?: unknown);
+    private redactCredentials;
+}
+/**
+ * API Request Error
+ */
+export declare class APIError extends MCPServerError {
+    readonly statusCode?: number | undefined;
+    readonly method?: string | undefined;
+    readonly url?: string | undefined;
+    readonly retryCount?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, method?: string | undefined, url?: string | undefined, retryCount?: number | undefined, details?: unknown);
+}
+/**
+ * Resource Validation Error
+ */
+export declare class ValidationError extends MCPServerError {
+    readonly filePath?: string | undefined;
+    readonly expectedFormat?: string | undefined;
+    readonly validationReason?: string | undefined;
+    constructor(message: string, filePath?: string | undefined, expectedFormat?: string | undefined, validationReason?: string | undefined, details?: unknown);
+}
+/**
+ * Filesystem Operation Error
+ */
+export declare class FileSystemError extends MCPServerError {
+    readonly operation: string;
+    readonly path?: string | undefined;
+    readonly systemErrorCode?: string | undefined;
+    readonly suggestedResolution?: string | undefined;
+    constructor(message: string, operation: string, path?: string | undefined, systemErrorCode?: string | undefined, suggestedResolution?: string | undefined, details?: unknown);
+}
+/**
+ * Error Factory Functions
+ */
+export declare function createGitError(operation: string, error: Error, repositoryUrl?: string): GitError;
+export declare function createAPIError(method: string, url: string, error: Error, statusCode?: number, retryCount?: number): APIError;
+export declare function createValidationError(filePath: string, expectedFormat: string, reason: string): ValidationError;
+export declare function createFileSystemError(operation: string, path: string, error: Error & {
+    code?: string;
+}, suggestedResolution?: string): FileSystemError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,OAAO,YAAA;CAMpC;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAAc;aAGxB,SAAS,EAAE,MAAM;aACjB,aAAa,CAAC,EAAE,MAAM;gBAFtC,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,YAAA,EACtC,OAAO,CAAC,EAAE,OAAO;IAUnB,OAAO,CAAC,iBAAiB;CAG1B;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAAc;aAGxB,UAAU,CAAC,EAAE,MAAM;aACnB,MAAM,CAAC,EAAE,MAAM;aACf,GAAG,CAAC,EAAE,MAAM;aACZ,UAAU,CAAC,EAAE,MAAM;gBAJnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,GAAG,CAAC,EAAE,MAAM,YAAA,EACZ,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,OAAO,CAAC,EAAE,OAAO;CAIpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;aAG/B,QAAQ,CAAC,EAAE,MAAM;aACjB,cAAc,CAAC,EAAE,MAAM;aACvB,gBAAgB,CAAC,EAAE,MAAM;gBAHzC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,cAAc,CAAC,EAAE,MAAM,YAAA,EACvB,gBAAgB,CAAC,EAAE,MAAM,YAAA,EACzC,OAAO,CAAC,EAAE,OAAO;CAIpB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,cAAc;aAG/B,SAAS,EAAE,MAAM;aACjB,IAAI,CAAC,EAAE,MAAM;aACb,eAAe,CAAC,EAAE,MAAM;aACxB,mBAAmB,CAAC,EAAE,MAAM;gBAJ5C,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,eAAe,CAAC,EAAE,MAAM,YAAA,EACxB,mBAAmB,CAAC,EAAE,MAAM,YAAA,EAC5C,OAAO,CAAC,EAAE,OAAO;CAIpB;AAED;;GAEG;AAEH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,QAAQ,CAOV;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,KAAK,EACZ,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,QAAQ,CAGV;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,eAAe,CAOjB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,eAAe,CASjB"}