@vibescope/mcp-server 0.0.1 → 0.2.0

package/dist/api-client.js

@@ -0,0 +1,713 @@
+/**
+ * Vibescope API Client
+ *
+ * HTTP client for communicating with the Vibescope API.
+ * All database operations are handled server-side through these endpoints.
+ */
+const DEFAULT_API_URL = 'https://vibescope.dev';
+export class VibescopeApiClient {
+    apiKey;
+    baseUrl;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl || process.env.VIBESCOPE_API_URL || DEFAULT_API_URL;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-API-Key': this.apiKey
+                },
+                body: body ? JSON.stringify(body) : undefined
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                return {
+                    ok: false,
+                    status: response.status,
+                    error: data.error || `HTTP ${response.status}`
+                };
+            }
+            return {
+                ok: true,
+                status: response.status,
+                data
+            };
+        }
+        catch (err) {
+            return {
+                ok: false,
+                status: 0,
+                error: err instanceof Error ? err.message : 'Network error'
+            };
+        }
+    }
+    // Auth endpoints
+    async validateAuth() {
+        return this.request('POST', '/api/mcp/auth/validate', {
+            api_key: this.apiKey
+        });
+    }
+    // Session endpoints
+    async startSession(params) {
+        return this.request('POST', '/api/mcp/sessions/start', params);
+    }
+    async heartbeat(sessionId, options) {
+        return this.request('POST', '/api/mcp/sessions/heartbeat', {
+            session_id: sessionId,
+            ...options
+        });
+    }
+    async endSession(sessionId) {
+        return this.request('POST', '/api/mcp/sessions/end', {
+            session_id: sessionId
+        });
+    }
+    // Project endpoints
+    async listProjects() {
+        return this.request('GET', '/api/mcp/projects');
+    }
+    async createProject(params) {
+        return this.request('POST', '/api/mcp/projects', params);
+    }
+    async getProject(projectId, gitUrl) {
+        const url = gitUrl
+            ? `/api/mcp/projects/${projectId}?git_url=${encodeURIComponent(gitUrl)}`
+            : `/api/mcp/projects/${projectId}`;
+        return this.request('GET', url);
+    }
+    async updateProject(projectId, updates) {
+        return this.request('PATCH', `/api/mcp/projects/${projectId}`, updates);
+    }
+    // Task endpoints
+    async getTasks(projectId, params) {
+        const queryParams = new URLSearchParams();
+        if (params?.status)
+            queryParams.set('status', params.status);
+        if (params?.limit)
+            queryParams.set('limit', params.limit.toString());
+        if (params?.offset)
+            queryParams.set('offset', params.offset.toString());
+        if (params?.include_subtasks)
+            queryParams.set('include_subtasks', 'true');
+        if (params?.search_query)
+            queryParams.set('search_query', params.search_query);
+        if (params?.include_metadata)
+            queryParams.set('include_metadata', 'true');
+        const query = queryParams.toString();
+        const url = `/api/mcp/projects/${projectId}/tasks${query ? `?${query}` : ''}`;
+        return this.request('GET', url);
+    }
+    async createTask(projectId, params) {
+        return this.request('POST', `/api/mcp/projects/${projectId}/tasks`, params);
+    }
+    async getNextTask(projectId, sessionId) {
+        const url = sessionId
+            ? `/api/mcp/projects/${projectId}/next-task?session_id=${sessionId}`
+            : `/api/mcp/projects/${projectId}/next-task`;
+        return this.request('GET', url);
+    }
+    async getTask(taskId) {
+        return this.request('GET', `/api/mcp/tasks/${taskId}`);
+    }
+    async updateTask(taskId, updates) {
+        return this.request('PATCH', `/api/mcp/tasks/${taskId}`, updates);
+    }
+    async completeTask(taskId, params) {
+        return this.request('POST', `/api/mcp/tasks/${taskId}/complete`, params);
+    }
+    async deleteTask(taskId) {
+        return this.request('DELETE', `/api/mcp/tasks/${taskId}`);
+    }
+    // Progress endpoints
+    async logProgress(projectId, params) {
+        return this.request('POST', `/api/mcp/projects/${projectId}/progress`, params);
+    }
+    // Git workflow endpoint
+    async getGitWorkflow(projectId, taskId) {
+        const url = taskId
+            ? `/api/mcp/projects/${projectId}/git-workflow?task_id=${taskId}`
+            : `/api/mcp/projects/${projectId}/git-workflow`;
+        return this.request('GET', url);
+    }
+    // ============================================================================
+    // Proxy endpoint - Generic method for all operations
+    // ============================================================================
+    async proxy(operation, args, sessionContext) {
+        return this.request('POST', '/api/mcp/proxy', {
+            operation,
+            args,
+            session_context: sessionContext
+        });
+    }
+    // ============================================================================
+    // Blocker endpoints
+    // ============================================================================
+    async getBlockers(projectId, params) {
+        return this.proxy('get_blockers', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async addBlocker(projectId, description, sessionId) {
+        return this.proxy('add_blocker', { project_id: projectId, description }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async resolveBlocker(blockerId, resolutionNote) {
+        return this.proxy('resolve_blocker', {
+            blocker_id: blockerId,
+            resolution_note: resolutionNote
+        });
+    }
+    async deleteBlocker(blockerId) {
+        return this.proxy('delete_blocker', { blocker_id: blockerId });
+    }
+    // ============================================================================
+    // Decision endpoints
+    // ============================================================================
+    async getDecisions(projectId) {
+        return this.proxy('get_decisions', { project_id: projectId });
+    }
+    async logDecision(projectId, params, sessionId) {
+        return this.proxy('log_decision', {
+            project_id: projectId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async deleteDecision(decisionId) {
+        return this.proxy('delete_decision', { decision_id: decisionId });
+    }
+    // ============================================================================
+    // Idea endpoints
+    // ============================================================================
+    async getIdeas(projectId, params) {
+        return this.proxy('get_ideas', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async addIdea(projectId, params, sessionId) {
+        return this.proxy('add_idea', {
+            project_id: projectId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async updateIdea(ideaId, updates) {
+        return this.proxy('update_idea', {
+            idea_id: ideaId,
+            ...updates
+        });
+    }
+    async deleteIdea(ideaId) {
+        return this.proxy('delete_idea', { idea_id: ideaId });
+    }
+    async convertIdeaToTask(ideaId, params) {
+        return this.proxy('convert_idea_to_task', {
+            idea_id: ideaId,
+            ...params
+        });
+    }
+    // ============================================================================
+    // Finding endpoints
+    // ============================================================================
+    async getFindings(projectId, params) {
+        return this.proxy('get_findings', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getFindingsStats(projectId) {
+        return this.proxy('get_findings_stats', {
+            project_id: projectId
+        });
+    }
+    async addFinding(projectId, params, sessionId) {
+        return this.proxy('add_finding', {
+            project_id: projectId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async updateFinding(findingId, updates) {
+        return this.proxy('update_finding', {
+            finding_id: findingId,
+            ...updates
+        });
+    }
+    async deleteFinding(findingId) {
+        return this.proxy('delete_finding', { finding_id: findingId });
+    }
+    // ============================================================================
+    // Milestone endpoints
+    // ============================================================================
+    async getMilestones(taskId) {
+        return this.proxy('get_milestones', { task_id: taskId });
+    }
+    async addMilestone(taskId, params, sessionId) {
+        return this.proxy('add_milestone', {
+            task_id: taskId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async updateMilestone(milestoneId, updates) {
+        return this.proxy('update_milestone', {
+            milestone_id: milestoneId,
+            ...updates
+        });
+    }
+    async completeMilestone(milestoneId) {
+        return this.proxy('complete_milestone', { milestone_id: milestoneId });
+    }
+    async deleteMilestone(milestoneId) {
+        return this.proxy('delete_milestone', { milestone_id: milestoneId });
+    }
+    // ============================================================================
+    // Request endpoints
+    // ============================================================================
+    async getPendingRequests(projectId, sessionId) {
+        return this.proxy('get_pending_requests', { project_id: projectId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async acknowledgeRequest(requestId, sessionId) {
+        return this.proxy('acknowledge_request', { request_id: requestId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async answerQuestion(requestId, answer, sessionId) {
+        return this.proxy('answer_question', {
+            request_id: requestId,
+            answer
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    // ============================================================================
+    // Validation endpoints
+    // ============================================================================
+    async getTasksAwaitingValidation(projectId) {
+        return this.proxy('get_tasks_awaiting_validation', { project_id: projectId });
+    }
+    async claimValidation(taskId, sessionId) {
+        return this.proxy('claim_validation', { task_id: taskId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async validateTask(taskId, params, sessionId) {
+        return this.proxy('validate_task', {
+            task_id: taskId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    // ============================================================================
+    // Fallback activity endpoints
+    // ============================================================================
+    async startFallbackActivity(projectId, activity, sessionId) {
+        return this.proxy('start_fallback_activity', {
+            project_id: projectId,
+            activity
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async stopFallbackActivity(projectId, summary, sessionId) {
+        return this.proxy('stop_fallback_activity', {
+            project_id: projectId,
+            summary
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async getActivityHistory(projectId, params) {
+        return this.proxy('get_activity_history', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getActivitySchedules(projectId) {
+        return this.proxy('get_activity_schedules', { project_id: projectId });
+    }
+    // ============================================================================
+    // Subtask endpoints
+    // ============================================================================
+    async addSubtask(parentTaskId, params, sessionId) {
+        return this.proxy('add_subtask', {
+            parent_task_id: parentTaskId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async getSubtasks(parentTaskId, status) {
+        return this.proxy('get_subtasks', {
+            parent_task_id: parentTaskId,
+            status
+        });
+    }
+    // ============================================================================
+    // Activity feed endpoint
+    // ============================================================================
+    async getActivityFeed(projectId, params) {
+        return this.proxy('get_activity_feed', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    // ============================================================================
+    // Deployment endpoints
+    // ============================================================================
+    async requestDeployment(projectId, params, sessionId) {
+        return this.proxy('request_deployment', {
+            project_id: projectId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async checkDeploymentStatus(projectId) {
+        return this.proxy('check_deployment_status', { project_id: projectId });
+    }
+    async claimDeploymentValidation(projectId, sessionId) {
+        return this.proxy('claim_deployment_validation', { project_id: projectId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async reportValidation(projectId, params) {
+        return this.proxy('report_validation', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async startDeployment(projectId, sessionId) {
+        return this.proxy('start_deployment', { project_id: projectId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async completeDeployment(projectId, params) {
+        return this.proxy('complete_deployment', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async cancelDeployment(projectId, reason) {
+        return this.proxy('cancel_deployment', {
+            project_id: projectId,
+            reason
+        });
+    }
+    // ============================================================================
+    // Task reference endpoints
+    // ============================================================================
+    async addTaskReference(taskId, url, label) {
+        return this.proxy('add_task_reference', {
+            task_id: taskId,
+            url,
+            label
+        });
+    }
+    async removeTaskReference(taskId, url) {
+        return this.proxy('remove_task_reference', {
+            task_id: taskId,
+            url
+        });
+    }
+    // ============================================================================
+    // Knowledge base endpoint
+    // ============================================================================
+    async queryKnowledgeBase(projectId, params) {
+        return this.proxy('query_knowledge_base', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    // ============================================================================
+    // Session sync endpoint
+    // ============================================================================
+    async syncSession(sessionId, params) {
+        return this.proxy('sync_session', {
+            session_id: sessionId,
+            ...params
+        });
+    }
+    // ============================================================================
+    // Organization endpoints
+    // ============================================================================
+    async listOrganizations() {
+        return this.proxy('list_organizations', {});
+    }
+    async createOrganization(params) {
+        return this.proxy('create_organization', params);
+    }
+    async updateOrganization(organizationId, updates) {
+        return this.proxy('update_organization', {
+            organization_id: organizationId,
+            ...updates
+        });
+    }
+    async deleteOrganization(organizationId) {
+        return this.proxy('delete_organization', { organization_id: organizationId });
+    }
+    async listOrgMembers(organizationId) {
+        return this.proxy('list_org_members', { organization_id: organizationId });
+    }
+    async inviteMember(organizationId, email, role) {
+        return this.proxy('invite_member', {
+            organization_id: organizationId,
+            email,
+            role
+        });
+    }
+    async updateMemberRole(organizationId, userId, role) {
+        return this.proxy('update_member_role', {
+            organization_id: organizationId,
+            user_id: userId,
+            role
+        });
+    }
+    async removeMember(organizationId, userId) {
+        return this.proxy('remove_member', {
+            organization_id: organizationId,
+            user_id: userId
+        });
+    }
+    async shareProjectWithOrg(projectId, organizationId, permission) {
+        return this.proxy('share_project_with_org', {
+            project_id: projectId,
+            organization_id: organizationId,
+            permission
+        });
+    }
+    async unshareProject(projectId, organizationId) {
+        return this.proxy('unshare_project', {
+            project_id: projectId,
+            organization_id: organizationId
+        });
+    }
+    async leaveOrganization(organizationId) {
+        return this.proxy('leave_organization', { organization_id: organizationId });
+    }
+    async updateProjectShare(projectId, organizationId, permission) {
+        return this.proxy('update_project_share', {
+            project_id: projectId,
+            organization_id: organizationId,
+            permission
+        });
+    }
+    async listProjectShares(projectId) {
+        return this.proxy('list_project_shares', { project_id: projectId });
+    }
+    // ============================================================================
+    // Body of work endpoints
+    // ============================================================================
+    async createBodyOfWork(projectId, params) {
+        return this.proxy('create_body_of_work', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getBodyOfWork(bodyOfWorkId) {
+        return this.proxy('get_body_of_work', { body_of_work_id: bodyOfWorkId });
+    }
+    async getBodiesOfWork(projectId, params) {
+        return this.proxy('get_bodies_of_work', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async updateBodyOfWork(bodyOfWorkId, updates) {
+        return this.proxy('update_body_of_work', {
+            body_of_work_id: bodyOfWorkId,
+            ...updates
+        });
+    }
+    async deleteBodyOfWork(bodyOfWorkId) {
+        return this.proxy('delete_body_of_work', { body_of_work_id: bodyOfWorkId });
+    }
+    async addTaskToBodyOfWork(bodyOfWorkId, taskId, phase, orderIndex) {
+        return this.proxy('add_task_to_body_of_work', {
+            body_of_work_id: bodyOfWorkId,
+            task_id: taskId,
+            phase,
+            order_index: orderIndex
+        });
+    }
+    async removeTaskFromBodyOfWork(taskId) {
+        return this.proxy('remove_task_from_body_of_work', { task_id: taskId });
+    }
+    async activateBodyOfWork(bodyOfWorkId) {
+        return this.proxy('activate_body_of_work', { body_of_work_id: bodyOfWorkId });
+    }
+    async addTaskDependency(bodyOfWorkId, taskId, dependsOnTaskId) {
+        return this.proxy('add_task_dependency', {
+            body_of_work_id: bodyOfWorkId,
+            task_id: taskId,
+            depends_on_task_id: dependsOnTaskId
+        });
+    }
+    async removeTaskDependency(taskId, dependsOnTaskId) {
+        return this.proxy('remove_task_dependency', {
+            task_id: taskId,
+            depends_on_task_id: dependsOnTaskId
+        });
+    }
+    async getTaskDependencies(params) {
+        return this.proxy('get_task_dependencies', params);
+    }
+    async getNextBodyOfWorkTask(bodyOfWorkId) {
+        return this.proxy('get_next_body_of_work_task', { body_of_work_id: bodyOfWorkId });
+    }
+    // ============================================================================
+    // Git issues endpoints
+    // ============================================================================
+    async addGitIssue(projectId, params, sessionId) {
+        return this.proxy('add_git_issue', {
+            project_id: projectId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async resolveGitIssue(gitIssueId, params, sessionId) {
+        return this.proxy('resolve_git_issue', {
+            git_issue_id: gitIssueId,
+            ...params
+        }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async getGitIssues(projectId, params) {
+        return this.proxy('get_git_issues', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async deleteGitIssue(gitIssueId) {
+        return this.proxy('delete_git_issue', { git_issue_id: gitIssueId });
+    }
+    // ============================================================================
+    // Cost tracking endpoints
+    // ============================================================================
+    async getCostSummary(projectId, params) {
+        return this.proxy('get_cost_summary', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getCostAlerts() {
+        return this.proxy('get_cost_alerts', {});
+    }
+    async addCostAlert(params) {
+        return this.proxy('add_cost_alert', params);
+    }
+    async updateCostAlert(alertId, updates) {
+        return this.proxy('update_cost_alert', {
+            alert_id: alertId,
+            ...updates
+        });
+    }
+    async deleteCostAlert(alertId) {
+        return this.proxy('delete_cost_alert', { alert_id: alertId });
+    }
+    async getTaskCosts(projectId, limit) {
+        return this.proxy('get_task_costs', {
+            project_id: projectId,
+            limit
+        });
+    }
+    async getTokenUsage() {
+        return this.proxy('get_token_usage', {});
+    }
+    // ============================================================================
+    // Batch operation endpoints
+    // ============================================================================
+    async batchUpdateTasks(updates) {
+        return this.proxy('batch_update_tasks', { updates });
+    }
+    async batchCompleteTasks(completions) {
+        return this.proxy('batch_complete_tasks', { completions });
+    }
+    // ============================================================================
+    // Deployment requirements and scheduling endpoints
+    // ============================================================================
+    async addDeploymentRequirement(projectId, params) {
+        return this.proxy('add_deployment_requirement', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getDeploymentRequirements(projectId, params) {
+        return this.proxy('get_deployment_requirements', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async completeDeploymentRequirement(requirementId) {
+        return this.proxy('complete_deployment_requirement', { requirement_id: requirementId });
+    }
+    async scheduleDeployment(projectId, params) {
+        return this.proxy('schedule_deployment', {
+            project_id: projectId,
+            ...params
+        });
+    }
+    async getScheduledDeployments(projectId, includeDisabled) {
+        return this.proxy('get_scheduled_deployments', {
+            project_id: projectId,
+            include_disabled: includeDisabled
+        });
+    }
+    async updateScheduledDeployment(scheduleId, updates) {
+        return this.proxy('update_scheduled_deployment', {
+            schedule_id: scheduleId,
+            ...updates
+        });
+    }
+    async deleteScheduledDeployment(scheduleId) {
+        return this.proxy('delete_scheduled_deployment', { schedule_id: scheduleId });
+    }
+    async triggerScheduledDeployment(scheduleId, sessionId) {
+        return this.proxy('trigger_scheduled_deployment', { schedule_id: scheduleId }, sessionId ? {
+            session_id: sessionId,
+            persona: null,
+            instance_id: ''
+        } : undefined);
+    }
+    async checkDueDeployments(projectId) {
+        return this.proxy('check_due_deployments', { project_id: projectId });
+    }
+    // ============================================================================
+    // Project README endpoint
+    // ============================================================================
+    async updateProjectReadme(projectId, readmeContent) {
+        return this.proxy('update_project_readme', {
+            project_id: projectId,
+            readme_content: readmeContent
+        });
+    }
+    // ============================================================================
+    // Help Topics (database-backed)
+    // ============================================================================
+    async getHelpTopic(slug) {
+        return this.proxy('get_help_topic', { slug });
+    }
+    async getHelpTopics() {
+        return this.proxy('get_help_topics', {});
+    }
+}
+// Singleton instance
+let apiClient = null;
+export function getApiClient() {
+    if (!apiClient) {
+        const apiKey = process.env.VIBESCOPE_API_KEY;
+        if (!apiKey) {
+            throw new Error('VIBESCOPE_API_KEY environment variable is required');
+        }
+        apiClient = new VibescopeApiClient({ apiKey });
+    }
+    return apiClient;
+}
+export function initApiClient(config) {
+    apiClient = new VibescopeApiClient(config);
+    return apiClient;
+}