@visualprd/mcp-server 1.1.0

package/dist/tools/index.d.ts

@@ -0,0 +1,803 @@
+/**
+ * MCP Tools
+ *
+ * Defines the tools exposed to AI agents via the MCP protocol.
+ * Each tool has a schema definition and handler function.
+ */
+import { z } from 'zod';
+import { IntelligenceLayer } from '../intelligence/index.js';
+export declare const ToolSchemas: {
+    get_next_build_step: z.ZodObject<{
+        skipCompleted: z.ZodOptional<z.ZodBoolean>;
+        preferCategory: z.ZodOptional<z.ZodEnum<["scaffold", "database", "pages", "integration", "testing", "deployment", "feature", "bugfix"]>>;
+    }, "strip", z.ZodTypeAny, {
+        skipCompleted?: boolean | undefined;
+        preferCategory?: "scaffold" | "database" | "pages" | "integration" | "testing" | "deployment" | "feature" | "bugfix" | undefined;
+    }, {
+        skipCompleted?: boolean | undefined;
+        preferCategory?: "scaffold" | "database" | "pages" | "integration" | "testing" | "deployment" | "feature" | "bugfix" | undefined;
+    }>;
+    mark_step_complete: z.ZodObject<{
+        promptId: z.ZodString;
+        completionNotes: z.ZodOptional<z.ZodString>;
+        filesCreated: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        testResults: z.ZodOptional<z.ZodObject<{
+            passed: z.ZodNumber;
+            failed: z.ZodNumber;
+            skipped: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            failed: number;
+            passed: number;
+            skipped?: number | undefined;
+        }, {
+            failed: number;
+            passed: number;
+            skipped?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        promptId: string;
+        completionNotes?: string | undefined;
+        filesCreated?: string[] | undefined;
+        testResults?: {
+            failed: number;
+            passed: number;
+            skipped?: number | undefined;
+        } | undefined;
+    }, {
+        promptId: string;
+        completionNotes?: string | undefined;
+        filesCreated?: string[] | undefined;
+        testResults?: {
+            failed: number;
+            passed: number;
+            skipped?: number | undefined;
+        } | undefined;
+    }>;
+    report_error: z.ZodObject<{
+        promptId: z.ZodString;
+        errorType: z.ZodEnum<["compile_error", "runtime_error", "test_failure", "missing_dependency", "other"]>;
+        errorMessage: z.ZodString;
+        stackTrace: z.ZodOptional<z.ZodString>;
+        context: z.ZodOptional<z.ZodString>;
+        affectedFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        promptId: string;
+        errorType: "other" | "compile_error" | "runtime_error" | "test_failure" | "missing_dependency";
+        errorMessage: string;
+        stackTrace?: string | undefined;
+        context?: string | undefined;
+        affectedFiles?: string[] | undefined;
+    }, {
+        promptId: string;
+        errorType: "other" | "compile_error" | "runtime_error" | "test_failure" | "missing_dependency";
+        errorMessage: string;
+        stackTrace?: string | undefined;
+        context?: string | undefined;
+        affectedFiles?: string[] | undefined;
+    }>;
+    get_entity_details: z.ZodObject<{
+        entityType: z.ZodEnum<["page", "schema", "endpoint", "tech"]>;
+        entityId: z.ZodString;
+        includeRelationships: z.ZodOptional<z.ZodBoolean>;
+        includeUsageExamples: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        entityType: "page" | "schema" | "endpoint" | "tech";
+        entityId: string;
+        includeRelationships?: boolean | undefined;
+        includeUsageExamples?: boolean | undefined;
+    }, {
+        entityType: "page" | "schema" | "endpoint" | "tech";
+        entityId: string;
+        includeRelationships?: boolean | undefined;
+        includeUsageExamples?: boolean | undefined;
+    }>;
+    get_debug_suggestions: z.ZodObject<{
+        currentTask: z.ZodString;
+        issue: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        attemptedSolutions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        currentTask: string;
+        issue: string;
+        context?: string | undefined;
+        attemptedSolutions?: string[] | undefined;
+    }, {
+        currentTask: string;
+        issue: string;
+        context?: string | undefined;
+        attemptedSolutions?: string[] | undefined;
+    }>;
+    inject_dynamic_step: z.ZodObject<{
+        insertAfter: z.ZodString;
+        title: z.ZodString;
+        category: z.ZodEnum<["scaffold", "database", "pages", "integration", "testing", "deployment", "feature", "bugfix"]>;
+        reason: z.ZodString;
+        instruction: z.ZodString;
+        relatedEntities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        estimatedMinutes: z.ZodOptional<z.ZodNumber>;
+        dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        category: "scaffold" | "database" | "pages" | "integration" | "testing" | "deployment" | "feature" | "bugfix";
+        instruction: string;
+        insertAfter: string;
+        reason: string;
+        estimatedMinutes?: number | undefined;
+        dependsOn?: string[] | undefined;
+        relatedEntities?: string[] | undefined;
+    }, {
+        title: string;
+        category: "scaffold" | "database" | "pages" | "integration" | "testing" | "deployment" | "feature" | "bugfix";
+        instruction: string;
+        insertAfter: string;
+        reason: string;
+        estimatedMinutes?: number | undefined;
+        dependsOn?: string[] | undefined;
+        relatedEntities?: string[] | undefined;
+    }>;
+    get_build_progress: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    get_design_system: z.ZodObject<{
+        section: z.ZodOptional<z.ZodEnum<["all", "colors", "typography", "spacing", "components"]>>;
+    }, "strip", z.ZodTypeAny, {
+        section?: "typography" | "spacing" | "all" | "colors" | "components" | undefined;
+    }, {
+        section?: "typography" | "spacing" | "all" | "colors" | "components" | undefined;
+    }>;
+    set_thinking_model: z.ZodObject<{
+        model: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+    }, {
+        model: string;
+    }>;
+    set_intelligence_mode: z.ZodObject<{
+        mode: z.ZodEnum<["fast", "deep"]>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "fast" | "deep";
+    }, {
+        mode: "fast" | "deep";
+    }>;
+    get_next_step_v2: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    submit_work: z.ZodObject<{
+        promptId: z.ZodString;
+        summary: z.ZodString;
+        filesCreated: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        errorsEncountered: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        notesForReview: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        promptId: string;
+        summary: string;
+        filesCreated?: string[] | undefined;
+        errorsEncountered?: string[] | undefined;
+        notesForReview?: string | undefined;
+    }, {
+        promptId: string;
+        summary: string;
+        filesCreated?: string[] | undefined;
+        errorsEncountered?: string[] | undefined;
+        notesForReview?: string | undefined;
+    }>;
+    get_build_progress_v2: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+};
+export declare const ToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            skipCompleted: {
+                type: string;
+                description: string;
+            };
+            preferCategory: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            promptId: {
+                type: string;
+                description: string;
+            };
+            completionNotes: {
+                type: string;
+                description: string;
+            };
+            filesCreated: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            testResults: {
+                type: string;
+                properties: {
+                    passed: {
+                        type: string;
+                    };
+                    failed: {
+                        type: string;
+                    };
+                    skipped: {
+                        type: string;
+                    };
+                };
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            promptId: {
+                type: string;
+                description: string;
+            };
+            errorType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            errorMessage: {
+                type: string;
+                description: string;
+            };
+            stackTrace: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            affectedFiles: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            entityType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            entityId: {
+                type: string;
+                description: string;
+            };
+            includeRelationships: {
+                type: string;
+                description: string;
+            };
+            includeUsageExamples: {
+                type: string;
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            currentTask: {
+                type: string;
+                description: string;
+            };
+            issue: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            attemptedSolutions: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            insertAfter: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            category: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+            instruction: {
+                type: string;
+                description: string;
+            };
+            relatedEntities: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            estimatedMinutes: {
+                type: string;
+                description: string;
+            };
+            dependsOn: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            section: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            model?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            model: {
+                type: string;
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            mode?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            mode: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            promptId?: undefined;
+            completionNotes?: undefined;
+            filesCreated?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            summary?: undefined;
+            errorsEncountered?: undefined;
+            notesForReview?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            promptId: {
+                type: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+            filesCreated: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            errorsEncountered: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            notesForReview: {
+                type: string;
+                description: string;
+            };
+            skipCompleted?: undefined;
+            preferCategory?: undefined;
+            completionNotes?: undefined;
+            testResults?: undefined;
+            errorType?: undefined;
+            errorMessage?: undefined;
+            stackTrace?: undefined;
+            context?: undefined;
+            affectedFiles?: undefined;
+            entityType?: undefined;
+            entityId?: undefined;
+            includeRelationships?: undefined;
+            includeUsageExamples?: undefined;
+            currentTask?: undefined;
+            issue?: undefined;
+            attemptedSolutions?: undefined;
+            insertAfter?: undefined;
+            title?: undefined;
+            category?: undefined;
+            reason?: undefined;
+            instruction?: undefined;
+            relatedEntities?: undefined;
+            estimatedMinutes?: undefined;
+            dependsOn?: undefined;
+            section?: undefined;
+            model?: undefined;
+            mode?: undefined;
+        };
+        required: string[];
+    };
+})[];
+/**
+ * Tool Handlers
+ *
+ * Execute tool requests using the Intelligence Layer
+ */
+export declare class ToolHandlers {
+    private intelligence;
+    constructor(intelligence: IntelligenceLayer);
+    handleToolCall(toolName: string, args: Record<string, any>): Promise<any>;
+    private handleGetNextStep;
+    private handleMarkComplete;
+    private handleReportError;
+    private handleGetEntity;
+    private handleGetDebugSuggestions;
+    private handleInjectStep;
+    private handleGetProgress;
+    private handleGetDesignSystem;
+    private handleSetThinkingModel;
+    private handleSetIntelligenceMode;
+    private handleGetNextStepV2;
+    private handleSubmitWork;
+    private handleGetProgressV2;
+}
+//# sourceMappingURL=index.d.ts.map