flowspec-mcp 2.1.1 → 3.0.0

package/dist/layout/semanticLayout.js

@@ -0,0 +1,233 @@
+import nlp from 'compromise';
+// ─── Layout Regions (9-grid system for infinite canvas) ─────────
+const LAYOUT_REGIONS = {
+    'top-left': { x: 0.05, y: 0.05 },
+    'top-center': { x: 0.4, y: 0.05 },
+    'top-right': { x: 0.7, y: 0.05 },
+    'center-left': { x: 0.05, y: 0.4 },
+    'center': { x: 0.4, y: 0.4 },
+    'center-right': { x: 0.7, y: 0.4 },
+    'bottom-left': { x: 0.05, y: 0.7 },
+    'bottom-center': { x: 0.4, y: 0.7 },
+    'bottom-right': { x: 0.7, y: 0.7 }
+};
+// Aliases for natural language
+const REGION_ALIASES = {
+    'top': 'top-center',
+    'bottom': 'bottom-center',
+    'left': 'center-left',
+    'right': 'center-right',
+    'upper-left': 'top-left',
+    'upper-right': 'top-right',
+    'lower-left': 'bottom-left',
+    'lower-right': 'bottom-right',
+    'middle': 'center'
+};
+// ─── Natural Language Parsing ────────────────────────────────────
+export function parseNaturalLanguageLayout(command, nodes, canvasBounds) {
+    const doc = nlp(command.toLowerCase());
+    // Extract action verb (move, arrange, cluster, position)
+    const verbs = doc.verbs().out('array');
+    const action = verbs[0] ?? 'move';
+    // Extract target nodes (by label matching)
+    const nodeMatches = extractNodeReferences(command, nodes);
+    if (nodeMatches.length === 0) {
+        return {
+            error: `No matching nodes found. Command: "${command}". Try specifying node labels explicitly (e.g., "move user auth nodes to top-right").`
+        };
+    }
+    // Extract target region
+    const region = extractTargetRegion(command);
+    if (!region) {
+        return {
+            error: `No target region found. Supported regions: ${Object.keys(LAYOUT_REGIONS).join(', ')}. Command: "${command}".`
+        };
+    }
+    // Extract arrangement style (vertical, horizontal, grid, cluster)
+    const arrangement = extractArrangement(command);
+    const direction = extractDirection(command);
+    // Convert region to absolute coordinates
+    const relativePos = LAYOUT_REGIONS[region];
+    const targetBounds = {
+        x: relativePos.x * canvasBounds.width,
+        y: relativePos.y * canvasBounds.height,
+        width: canvasBounds.width * 0.25, // 25% of canvas for layout region
+        height: canvasBounds.height * 0.25
+    };
+    return {
+        nodeIds: nodeMatches,
+        targetBounds,
+        arrangement,
+        direction
+    };
+}
+function extractNodeReferences(command, nodes) {
+    const matches = [];
+    // Extract potential node label keywords (nouns, adjectives)
+    const doc = nlp(command);
+    const keywords = [
+        ...doc.nouns().out('array'),
+        ...doc.adjectives().out('array')
+    ];
+    // Match keywords against node labels (fuzzy matching)
+    for (const node of nodes) {
+        const label = (node.data?.label ?? '').toLowerCase();
+        if (!label)
+            continue;
+        // Check if any keyword appears in label
+        for (const keyword of keywords) {
+            if (label.includes(keyword) || keyword.includes(label)) {
+                matches.push(node.id);
+                break;
+            }
+        }
+    }
+    return [...new Set(matches)]; // Deduplicate
+}
+function extractTargetRegion(command) {
+    const lowerCommand = command.toLowerCase();
+    // Check for explicit region names
+    for (const [alias, canonical] of Object.entries(REGION_ALIASES)) {
+        if (lowerCommand.includes(alias)) {
+            return canonical;
+        }
+    }
+    for (const region of Object.keys(LAYOUT_REGIONS)) {
+        if (lowerCommand.includes(region)) {
+            return region;
+        }
+    }
+    // Pattern matching: "to the <direction>"
+    if (lowerCommand.includes('to the top'))
+        return 'top-center';
+    if (lowerCommand.includes('to the bottom'))
+        return 'bottom-center';
+    if (lowerCommand.includes('to the left'))
+        return 'center-left';
+    if (lowerCommand.includes('to the right'))
+        return 'center-right';
+    // Pattern matching: "in the <region>"
+    if (lowerCommand.includes('in the top left'))
+        return 'top-left';
+    if (lowerCommand.includes('in the top right'))
+        return 'top-right';
+    if (lowerCommand.includes('in the bottom left'))
+        return 'bottom-left';
+    if (lowerCommand.includes('in the bottom right'))
+        return 'bottom-right';
+    if (lowerCommand.includes('in the center'))
+        return 'center';
+    return null;
+}
+function extractArrangement(command) {
+    const lowerCommand = command.toLowerCase();
+    if (lowerCommand.includes('stack') || lowerCommand.includes('column') || lowerCommand.includes('row')) {
+        return 'stack';
+    }
+    if (lowerCommand.includes('grid')) {
+        return 'grid';
+    }
+    if (lowerCommand.includes('flow')) {
+        return 'flow';
+    }
+    if (lowerCommand.includes('cluster') || lowerCommand.includes('group')) {
+        return 'cluster';
+    }
+    // Default: stack for small groups, grid for larger
+    return 'stack';
+}
+function extractDirection(command) {
+    const lowerCommand = command.toLowerCase();
+    if (lowerCommand.includes('vertical') || lowerCommand.includes('vertically') || lowerCommand.includes('column')) {
+        return 'vertical';
+    }
+    if (lowerCommand.includes('horizontal') || lowerCommand.includes('horizontally') || lowerCommand.includes('row')) {
+        return 'horizontal';
+    }
+    return undefined; // Let arrangement logic decide
+}
+// ─── Apply Semantic Layout ───────────────────────────────────────
+export function applySemanticLayout(nodes, edges, command) {
+    const positions = new Map();
+    const targetNodes = nodes.filter((n) => command.nodeIds.includes(n.id));
+    if (targetNodes.length === 0)
+        return positions;
+    const { targetBounds, arrangement, direction } = command;
+    switch (arrangement) {
+        case 'stack': {
+            // Stack vertically or horizontally
+            const isVertical = direction === 'vertical' || direction === undefined;
+            const spacing = 60;
+            targetNodes.forEach((node, index) => {
+                if (isVertical) {
+                    positions.set(node.id, {
+                        x: targetBounds.x,
+                        y: targetBounds.y + index * spacing
+                    });
+                }
+                else {
+                    positions.set(node.id, {
+                        x: targetBounds.x + index * spacing,
+                        y: targetBounds.y
+                    });
+                }
+            });
+            break;
+        }
+        case 'grid': {
+            // Arrange in a grid (3 columns max)
+            const cols = Math.min(3, Math.ceil(Math.sqrt(targetNodes.length)));
+            const spacing = 80;
+            targetNodes.forEach((node, index) => {
+                const col = index % cols;
+                const row = Math.floor(index / cols);
+                positions.set(node.id, {
+                    x: targetBounds.x + col * spacing,
+                    y: targetBounds.y + row * spacing
+                });
+            });
+            break;
+        }
+        case 'flow': {
+            // Flow layout (left-to-right, wrapping)
+            const maxWidth = targetBounds.width;
+            const spacing = 70;
+            let currentX = targetBounds.x;
+            let currentY = targetBounds.y;
+            for (const node of targetNodes) {
+                positions.set(node.id, { x: currentX, y: currentY });
+                currentX += spacing;
+                if (currentX - targetBounds.x > maxWidth) {
+                    currentX = targetBounds.x;
+                    currentY += spacing;
+                }
+            }
+            break;
+        }
+        case 'cluster': {
+            // Cluster in a compact circle/ellipse
+            const centerX = targetBounds.x + targetBounds.width / 2;
+            const centerY = targetBounds.y + targetBounds.height / 2;
+            const radius = Math.min(targetBounds.width, targetBounds.height) / 3;
+            targetNodes.forEach((node, index) => {
+                const angle = (index / targetNodes.length) * 2 * Math.PI;
+                positions.set(node.id, {
+                    x: centerX + radius * Math.cos(angle),
+                    y: centerY + radius * Math.sin(angle)
+                });
+            });
+            break;
+        }
+    }
+    return positions;
+}
+// ─── Supported Commands (for tool description) ───────────────────
+export const SUPPORTED_COMMANDS = [
+    'move <nodes> to <region>',
+    'arrange <nodes> vertically/horizontally in <region>',
+    'cluster <nodes> in <region>',
+    'position <nodes> at <region>',
+    'stack <nodes> in <region>'
+];
+export const SUPPORTED_REGIONS = Object.keys(LAYOUT_REGIONS);
+//# sourceMappingURL=semanticLayout.js.map

package/dist/layout/semanticLayout.js.map

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

package/dist/server.js

@@ -14,11 +14,23 @@ import { deleteNodeSchema, handleDeleteNode } from './tools/deleteNode.js';
 import { createEdgeSchema, handleCreateEdge } from './tools/createEdge.js';
 import { deleteEdgeSchema, handleDeleteEdge } from './tools/deleteEdge.js';
 import { analyseProjectSchema, handleAnalyseProject } from './tools/analyseProject.js';
+// v3 write tools
+import { importYamlSchema, handleImportYaml } from './tools/importYaml.js';
+import { autoLayoutSchema, handleAutoLayout } from './tools/autoLayout.js';
+import { uploadImageSchema, handleUploadImage } from './tools/uploadImage.js';
+import { createScreenSchema, handleCreateScreen } from './tools/createScreen.js';
+import { updateScreenSchema, handleUpdateScreen } from './tools/updateScreen.js';
+import { deleteScreenSchema, handleDeleteScreen } from './tools/deleteScreen.js';
+import { addRegionSchema, handleAddRegion } from './tools/addRegion.js';
+import { updateRegionSchema, handleUpdateRegion } from './tools/updateRegion.js';
+import { removeRegionSchema, handleRemoveRegion } from './tools/removeRegion.js';
+import { updateEdgeSchema, handleUpdateEdge } from './tools/updateEdge.js';
+import { cloneProjectSchema, handleCloneProject } from './tools/cloneProject.js';
 import { MODE } from './config.js';
 export function createServer() {
     const server = new McpServer({
         name: 'flowspec',
-        version: '2.1.1',
+        version: '3.0.0',
     });
     // ─── Read tools ──────────────────────────────────────────────────
     server.tool('flowspec_list_projects', 'List all FlowSpec projects with names and dates', listProjectsSchema.shape, handleListProjects);
@@ -36,7 +48,19 @@ export function createServer() {
     server.tool('flowspec_create_edge', 'Connect two nodes with an edge type (flows-to, derives-from, transforms, validates, contains)', createEdgeSchema.shape, handleCreateEdge);
     server.tool('flowspec_delete_edge', 'Remove an edge from a project', deleteEdgeSchema.shape, handleDeleteEdge);
     server.tool('flowspec_analyse_project', 'Run orphan node and duplicate label analysis on a project', analyseProjectSchema.shape, handleAnalyseProject);
-    console.error(`FlowSpec MCP v2.1.1 — mode: ${MODE}`);
+    // ─── Write tools (v3) ────────────────────────────────────────────
+    server.tool('flowspec_import_yaml', 'Import YAML specification to create/merge nodes, edges, and screens', importYamlSchema.shape, handleImportYaml);
+    server.tool('flowspec_auto_layout', 'Apply automatic hierarchical layout (Dagre) to organize nodes', autoLayoutSchema.shape, handleAutoLayout);
+    server.tool('flowspec_upload_image', 'Upload an image and get its URL with auto-detected dimensions', uploadImageSchema.shape, handleUploadImage);
+    server.tool('flowspec_create_screen', 'Create a new wireframe screen with optional image', createScreenSchema.shape, handleCreateScreen);
+    server.tool('flowspec_update_screen', 'Update screen properties (name, image)', updateScreenSchema.shape, handleUpdateScreen);
+    server.tool('flowspec_delete_screen', 'Delete a wireframe screen and all its regions', deleteScreenSchema.shape, handleDeleteScreen);
+    server.tool('flowspec_add_region', 'Add a region to a screen with % coordinates and element IDs', addRegionSchema.shape, handleAddRegion);
+    server.tool('flowspec_update_region', 'Update region position, size, label, or element IDs', updateRegionSchema.shape, handleUpdateRegion);
+    server.tool('flowspec_remove_region', 'Remove a region from a screen', removeRegionSchema.shape, handleRemoveRegion);
+    server.tool('flowspec_update_edge', 'Update edge type, label, or handle positions', updateEdgeSchema.shape, handleUpdateEdge);
+    server.tool('flowspec_clone_project', 'Clone a project for backup or branching', cloneProjectSchema.shape, handleCloneProject);
+    console.error(`FlowSpec MCP v3.0.0 — mode: ${MODE}`);
     return server;
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/addRegion.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+export declare const addRegionSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    screenId: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    position: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        x: number;
+        y: number;
+    }, {
+        x: number;
+        y: number;
+    }>;
+    size: z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>;
+    elementIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    componentNodeId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    projectId: string;
+    screenId: string;
+    label?: string | undefined;
+    elementIds?: string[] | undefined;
+    componentNodeId?: string | undefined;
+}, {
+    position: {
+        x: number;
+        y: number;
+    };
+    size: {
+        width: number;
+        height: number;
+    };
+    projectId: string;
+    screenId: string;
+    label?: string | undefined;
+    elementIds?: string[] | undefined;
+    componentNodeId?: string | undefined;
+}>;
+export declare function handleAddRegion(args: z.infer<typeof addRegionSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/addRegion.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { addRegionViaApi } from '../db.js';
+export const addRegionSchema = z.object({
+    projectId: z.string().describe('UUID of the project'),
+    screenId: z.string().describe('UUID of the screen'),
+    label: z.string().optional().describe('Region label (e.g. "Login Form")'),
+    position: z.object({
+        x: z.number().describe('Left edge, percentage 0-100'),
+        y: z.number().describe('Top edge, percentage 0-100'),
+    }).describe('Top-left corner position in percentage coordinates'),
+    size: z.object({
+        width: z.number().describe('Width, percentage 0-100'),
+        height: z.number().describe('Height, percentage 0-100'),
+    }).describe('Region size in percentage coordinates'),
+    elementIds: z.array(z.string()).optional().describe('Canvas node IDs linked to this region'),
+    componentNodeId: z.string().optional().describe('Component node ID when region is promoted'),
+});
+export async function handleAddRegion(args) {
+    const region = await addRegionViaApi(args.projectId, args.screenId, {
+        label: args.label,
+        position: args.position,
+        size: args.size,
+        elementIds: args.elementIds,
+        componentNodeId: args.componentNodeId,
+    });
+    if (!region) {
+        return {
+            content: [{ type: 'text', text: `Failed to add region — project or screen not found` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: `Added region **${region.label ?? region.id}** to screen (id: ${region.id})`,
+            }],
+    };
+}
+//# sourceMappingURL=addRegion.js.map

package/dist/tools/addRegion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addRegion.js","sourceRoot":"","sources":["../../src/tools/addRegion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACnD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACzE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QACrD,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;KACrD,CAAC,CAAC,QAAQ,CAAC,oDAAoD,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;KACxD,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC5F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC7F,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAqC;IACzE,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE;QAClE,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;KACtC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oDAAoD,EAAE,CAAC;YAChG,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,kBAAkB,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,qBAAqB,MAAM,CAAC,EAAE,GAAG;aACnF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/autoLayout.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const autoLayoutSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<["TB", "BT", "LR", "RL"]>>;
+    pinnedNodeIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    projectId: string;
+    direction?: "TB" | "BT" | "LR" | "RL" | undefined;
+    pinnedNodeIds?: string[] | undefined;
+}, {
+    projectId: string;
+    direction?: "TB" | "BT" | "LR" | "RL" | undefined;
+    pinnedNodeIds?: string[] | undefined;
+}>;
+export declare function handleAutoLayout(args: z.infer<typeof autoLayoutSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;

package/dist/tools/autoLayout.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { getProject, updateProjectViaApi } from '../db.js';
+import { computeAutoLayout } from '../layout/autoLayout.js';
+export const autoLayoutSchema = z.object({
+    projectId: z.string().describe('UUID of the project'),
+    direction: z.enum(['TB', 'BT', 'LR', 'RL']).optional().describe('Layout direction (default: TB — top-to-bottom)'),
+    pinnedNodeIds: z.array(z.string()).optional().describe('Node IDs to keep in their current positions'),
+});
+export async function handleAutoLayout(args) {
+    const project = await getProject(args.projectId);
+    if (!project) {
+        return {
+            content: [{ type: 'text', text: `Project not found: ${args.projectId}` }],
+            isError: true,
+        };
+    }
+    const nodes = project.canvas_state.nodes ?? [];
+    const edges = project.canvas_state.edges ?? [];
+    if (nodes.length === 0) {
+        return {
+            content: [{ type: 'text', text: 'No nodes to layout' }],
+        };
+    }
+    const direction = args.direction ?? 'TB';
+    const pinnedNodeIds = new Set(args.pinnedNodeIds ?? []);
+    const positions = computeAutoLayout(nodes, edges, { rankdir: direction, pinnedNodeIds });
+    // Apply positions to nodes
+    let movedCount = 0;
+    for (const node of nodes) {
+        const pos = positions.get(node.id);
+        if (pos) {
+            node.position = pos;
+            movedCount++;
+        }
+    }
+    const updated = await updateProjectViaApi(args.projectId, {
+        canvas_state: project.canvas_state,
+    });
+    if (!updated) {
+        return {
+            content: [{ type: 'text', text: `Failed to save layout changes` }],
+            isError: true,
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: `Auto-layout complete — repositioned ${movedCount} nodes (direction: ${direction}, pinned: ${pinnedNodeIds.size})`,
+            }],
+    };
+}
+//# sourceMappingURL=autoLayout.js.map

package/dist/tools/autoLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoLayout.js","sourceRoot":"","sources":["../../src/tools/autoLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACjH,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CACtG,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAsC;IAC3E,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,EAAE,CAAC;IAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC;SACjE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;IAEzF,2BAA2B;IAC3B,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,GAAG,EAAE,CAAC;YACR,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;YACpB,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,SAAS,EAAE;QACxD,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;YAC3E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,uCAAuC,UAAU,sBAAsB,SAAS,aAAa,aAAa,CAAC,IAAI,GAAG;aACzH,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/captureScreen.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export declare const captureScreenSchema: z.ZodObject<{
+    url: z.ZodString;
+    selector: z.ZodOptional<z.ZodString>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        width: number;
+        height: number;
+    }, {
+        width: number;
+        height: number;
+    }>>;
+    waitFor: z.ZodOptional<z.ZodString>;
+    fullPage: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    fullPage: boolean;
+    selector?: string | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    waitFor?: string | undefined;
+}, {
+    url: string;
+    selector?: string | undefined;
+    viewport?: {
+        width: number;
+        height: number;
+    } | undefined;
+    waitFor?: string | undefined;
+    fullPage?: boolean | undefined;
+}>;
+export declare function handleCaptureScreen(args: z.infer<typeof captureScreenSchema>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+}>;