@flowdot.ai/mcp-server 1.0.3 → 1.0.5

package/dist/tools/delete-node.d.ts

@@ -1,13 +1,7 @@
-/**
- * delete_node MCP Tool
- *
- * Deletes a node from a workflow.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const deleteNodeTool: Tool;
 export declare function handleDeleteNode(api: FlowDotApiClient, args: {
     workflow_id: string;
     node_id: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=delete-node.d.ts.map

package/dist/tools/delete-node.js

@@ -1,8 +1,3 @@
-/**
- * delete_node MCP Tool
- *
- * Deletes a node from a workflow.
- */
 export const deleteNodeTool = {
     name: 'delete_node',
     description: 'Delete a node from a workflow. This also removes all connections to/from the node.',
@@ -23,7 +18,6 @@ export const deleteNodeTool = {
 };
 export async function handleDeleteNode(api, args) {
     try {
-        // API may return undefined (no data wrapper) or { message: "..." }
         const result = await api.deleteNode(args.workflow_id, args.node_id);
         const message = result?.message || `Node ${args.node_id} has been deleted.`;
         return {
@@ -38,4 +32,3 @@ export async function handleDeleteNode(api, args) {
         };
     }
 }
-//# sourceMappingURL=delete-node.js.map

package/dist/tools/delete-recipe-step.d.ts

@@ -1,14 +1,8 @@
-/**
- * delete_recipe_step MCP Tool
- *
- * Deletes a step from a recipe.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const deleteRecipeStepTool: Tool;
 export declare function handleDeleteRecipeStep(api: FlowDotApiClient, args: {
     hash: string;
     step_id: string;
     confirm: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=delete-recipe-step.d.ts.map

package/dist/tools/delete-recipe-step.js

@@ -1,8 +1,3 @@
-/**
- * delete_recipe_step MCP Tool
- *
- * Deletes a step from a recipe.
- */
 export const deleteRecipeStepTool = {
     name: 'delete_recipe_step',
     description: 'Delete a step from a recipe. References to this step will need to be updated.',
@@ -42,8 +37,8 @@ export async function handleDeleteRecipeStep(api, args) {
             content: [
                 {
                     type: 'text',
-                    text: `Step ${args.step_id} has been deleted from the recipe.
-
+                    text: `Step ${args.step_id} has been deleted from the recipe.
+
 Note: Update any steps that referenced this step in their 'next' or 'on_error' fields.`,
                 },
             ],
@@ -62,4 +57,3 @@ Note: Update any steps that referenced this step in their 'next' or 'on_error' f
         };
     }
 }
-//# sourceMappingURL=delete-recipe-step.js.map

package/dist/tools/delete-recipe-store.d.ts

@@ -1,14 +1,8 @@
-/**
- * delete_recipe_store MCP Tool
- *
- * Deletes a store from a recipe.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const deleteRecipeStoreTool: Tool;
 export declare function handleDeleteRecipeStore(api: FlowDotApiClient, args: {
     hash: string;
     store_id: string;
     confirm: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=delete-recipe-store.d.ts.map

package/dist/tools/delete-recipe-store.js

@@ -1,8 +1,3 @@
-/**
- * delete_recipe_store MCP Tool
- *
- * Deletes a store from a recipe.
- */
 export const deleteRecipeStoreTool = {
     name: 'delete_recipe_store',
     description: 'Delete a store from a recipe. Steps using this store will need to be updated.',
@@ -42,8 +37,8 @@ export async function handleDeleteRecipeStore(api, args) {
             content: [
                 {
                     type: 'text',
-                    text: `Store ${args.store_id} has been deleted from the recipe.
-
+                    text: `Store ${args.store_id} has been deleted from the recipe.
+
 Note: Update any steps that referenced this store in their configurations.`,
                 },
             ],
@@ -62,4 +57,3 @@ Note: Update any steps that referenced this store in their configurations.`,
         };
     }
 }
-//# sourceMappingURL=delete-recipe-store.js.map

package/dist/tools/delete-recipe.d.ts

@@ -1,13 +1,7 @@
-/**
- * delete_recipe MCP Tool
- *
- * Permanently deletes an agent recipe.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const deleteRecipeTool: Tool;
 export declare function handleDeleteRecipe(api: FlowDotApiClient, args: {
     hash: string;
     confirm: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=delete-recipe.d.ts.map

package/dist/tools/delete-recipe.js

@@ -1,8 +1,3 @@
-/**
- * delete_recipe MCP Tool
- *
- * Permanently deletes an agent recipe.
- */
 export const deleteRecipeTool = {
     name: 'delete_recipe',
     description: 'Permanently delete an agent recipe. This action cannot be undone.',
@@ -56,4 +51,3 @@ export async function handleDeleteRecipe(api, args) {
         };
     }
 }
-//# sourceMappingURL=delete-recipe.js.map

package/dist/tools/delete-workflow.d.ts

@@ -1,12 +1,6 @@
-/**
- * delete_workflow MCP Tool
- *
- * Deletes a workflow permanently.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const deleteWorkflowTool: Tool;
 export declare function handleDeleteWorkflow(api: FlowDotApiClient, args: {
     workflow_id: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=delete-workflow.d.ts.map

package/dist/tools/delete-workflow.js

@@ -1,8 +1,3 @@
-/**
- * delete_workflow MCP Tool
- *
- * Deletes a workflow permanently.
- */
 export const deleteWorkflowTool = {
     name: 'delete_workflow',
     description: 'Permanently delete a workflow. This action cannot be undone. Only the workflow owner can delete it.',
@@ -19,7 +14,6 @@ export const deleteWorkflowTool = {
 };
 export async function handleDeleteWorkflow(api, args) {
     try {
-        // API may return undefined (no data wrapper) or { message: "..." }
         const result = await api.deleteWorkflow(args.workflow_id);
         const message = result?.message || `Workflow ${args.workflow_id} has been permanently deleted.`;
         return {
@@ -34,4 +28,3 @@ export async function handleDeleteWorkflow(api, args) {
         };
     }
 }
-//# sourceMappingURL=delete-workflow.js.map

package/dist/tools/duplicate-workflow.d.ts

@@ -1,13 +1,7 @@
-/**
- * duplicate_workflow MCP Tool
- *
- * Duplicates/clones an existing workflow.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const duplicateWorkflowTool: Tool;
 export declare function handleDuplicateWorkflow(api: FlowDotApiClient, args: {
     workflow_id: string;
     name?: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=duplicate-workflow.d.ts.map

package/dist/tools/duplicate-workflow.js

@@ -1,8 +1,3 @@
-/**
- * duplicate_workflow MCP Tool
- *
- * Duplicates/clones an existing workflow.
- */
 export const duplicateWorkflowTool = {
     name: 'duplicate_workflow',
     description: 'Create a copy of an existing workflow. The new workflow will be private and editable.',
@@ -46,4 +41,3 @@ export async function handleDuplicateWorkflow(api, args) {
         };
     }
 }
-//# sourceMappingURL=duplicate-workflow.js.map

package/dist/tools/edit-app-code.d.ts

@@ -1,12 +1,4 @@
-/**
- * edit_app_code Tool
- *
- * Performs exact string replacement in app code.
- * Similar to find-and-replace - replaces old_string with new_string.
- * Required scope: apps:manage
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const editAppCodeTool: Tool;
 export declare function handleEditAppCode(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
-//# sourceMappingURL=edit-app-code.d.ts.map

package/dist/tools/edit-app-code.js

@@ -1,40 +1,33 @@
-/**
- * edit_app_code Tool
- *
- * Performs exact string replacement in app code.
- * Similar to find-and-replace - replaces old_string with new_string.
- * Required scope: apps:manage
- */
 export const editAppCodeTool = {
     name: 'edit_app_code',
-    description: `Performs exact string replacement in app code. Similar to find-and-replace.
-
-CRITICAL: Remember these rules when editing code:
-- NO IMPORTS - React is global
-- MUST include export default at the end: export default MyAppName;
-- NO FORM ELEMENTS - Use div + button with type="button" instead
-- Workflow results: Use getNodeOutput(result, nodeTitle) helper
-- ALL BUTTONS need type="button" attribute
-
-Use this tool when you need to:
-- Modify specific sections of existing app code
-- Replace a function, component, or code block
-- Fix bugs or update logic in the code
-
-IMPORTANT RULES:
-- old_string must exist EXACTLY in the code (including whitespace/indentation)
-- If old_string appears multiple times, the operation fails unless replace_all=true
-- Provide enough context in old_string to make it unique
-
-WORKFLOW FOR BUILDING LARGE APPS:
-1. Create app with minimal code: create_app(name: "MyApp")
-2. Set initial skeleton: update_app(code: "function MyApp() { ... } export default MyApp;")
-3. Use edit_app_code to incrementally replace/expand sections
-4. Use append_app_code to add helper functions before the export
-
-Example:
-- old_string: "return <div>Loading...</div>;"
-- new_string: "return <div className=\"p-4\"><h1>Hello World</h1></div>;"`,
+    description: `Performs exact string replacement in app code. Similar to find-and-replace.
+
+CRITICAL: Remember these rules when editing code:
+- NO IMPORTS - React is global
+- MUST include export default at the end: export default MyAppName;
+- NO FORM ELEMENTS - Use div + button with type="button" instead
+- Workflow results: Use getNodeOutput(result, nodeTitle) helper
+- ALL BUTTONS need type="button" attribute
+
+Use this tool when you need to:
+- Modify specific sections of existing app code
+- Replace a function, component, or code block
+- Fix bugs or update logic in the code
+
+IMPORTANT RULES:
+- old_string must exist EXACTLY in the code (including whitespace/indentation)
+- If old_string appears multiple times, the operation fails unless replace_all=true
+- Provide enough context in old_string to make it unique
+
+WORKFLOW FOR BUILDING LARGE APPS:
+1. Create app with minimal code: create_app(name: "MyApp")
+2. Set initial skeleton: update_app(code: "function MyApp() { ... } export default MyApp;")
+3. Use edit_app_code to incrementally replace/expand sections
+4. Use append_app_code to add helper functions before the export
+
+Example:
+- old_string: "return <div>Loading...</div>;"
+- new_string: "return <div className='p-4'><h1>Hello World</h1></div>;"`,
     inputSchema: {
         type: 'object',
         properties: {
@@ -81,19 +74,18 @@ export async function handleEditAppCode(client, args) {
         return {
             content: [{
                     type: 'text',
-                    text: `App code edited successfully!
-
-App ID: ${result.id}
-Field: ${result.field}
-Previous size: ${result.previous_length} bytes
-New size: ${result.new_length} bytes (${sizeChange} bytes)
+                    text: `App code edited successfully!
+
+App ID: ${result.id}
+Field: ${result.field}
+Previous size: ${result.previous_length} bytes
+New size: ${result.new_length} bytes (${sizeChange} bytes)
 Updated at: ${result.updated_at}`,
                 }],
         };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : 'Unknown error';
-        // Try to extract debug info from error message if it's a JSON parse failure issue
         let debugInfo = '';
         if (message.includes('not found')) {
             debugInfo = '\n\nTroubleshooting tips:\n' +
@@ -107,4 +99,3 @@ Updated at: ${result.updated_at}`,
         };
     }
 }
-//# sourceMappingURL=edit-app-code.js.map

package/dist/tools/execute-workflow.d.ts

@@ -1,10 +1,5 @@
-/**
- * execute_workflow MCP Tool
- *
- * Executes a FlowDot workflow.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const executeWorkflowTool: Tool;
 export declare function handleExecuteWorkflow(api: FlowDotApiClient, args: {
     workflow_id: string;
@@ -12,4 +7,3 @@ export declare function handleExecuteWorkflow(api: FlowDotApiClient, args: {
     wait_for_completion?: boolean;
     mode?: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=execute-workflow.d.ts.map

package/dist/tools/execute-workflow.js

@@ -1,8 +1,3 @@
-/**
- * execute_workflow MCP Tool
- *
- * Executes a FlowDot workflow.
- */
 export const executeWorkflowTool = {
     name: 'execute_workflow',
     description: 'Execute a FlowDot workflow by ID. Use list_workflows first to get available workflow IDs.',
@@ -36,7 +31,6 @@ export const executeWorkflowTool = {
 export async function handleExecuteWorkflow(api, args) {
     try {
         const result = await api.executeWorkflow(args.workflow_id, args.inputs || {}, args.wait_for_completion ?? true, args.mode || 'flowdot');
-        // Handle async execution (not waiting for completion)
         if (result.status === 'started' && result.message) {
             return {
                 content: [
@@ -47,7 +41,6 @@ export async function handleExecuteWorkflow(api, args) {
                 ],
             };
         }
-        // Handle completed execution with enhanced output formatting
         const lines = [
             'Workflow executed successfully.',
             '',
@@ -60,7 +53,6 @@ export async function handleExecuteWorkflow(api, args) {
             lines.push('```json');
             lines.push(JSON.stringify(result.outputs, null, 2));
             lines.push('```');
-            // Add individual output values for easy reading
             lines.push('');
             lines.push('## Output Values');
             for (const [key, val] of Object.entries(result.outputs)) {
@@ -74,7 +66,6 @@ export async function handleExecuteWorkflow(api, args) {
                 else {
                     displayVal = String(val);
                 }
-                // Truncate very long values for readability
                 if (displayVal.length > 500) {
                     displayVal = displayVal.substring(0, 500) + '... (truncated)';
                 }
@@ -82,7 +73,6 @@ export async function handleExecuteWorkflow(api, args) {
             }
         }
         else if (result.outputs) {
-            // Handle non-object outputs (string, number, etc.)
             lines.push('');
             lines.push('## Output');
             lines.push(`\`\`\`\n${String(result.outputs)}\n\`\`\``);
@@ -109,4 +99,3 @@ export async function handleExecuteWorkflow(api, args) {
         };
     }
 }
-//# sourceMappingURL=execute-workflow.js.map

package/dist/tools/favorite-custom-node.d.ts

@@ -1,14 +1,7 @@
-/**
- * favorite_custom_node MCP Tool
- *
- * Add or remove a custom node from favorites.
- * Scope: custom_nodes:manage
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const favoriteCustomNodeTool: Tool;
 export declare function handleFavoriteCustomNode(api: FlowDotApiClient, args: {
     node_id: string;
     favorite?: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=favorite-custom-node.d.ts.map

package/dist/tools/favorite-custom-node.js

@@ -1,9 +1,3 @@
-/**
- * favorite_custom_node MCP Tool
- *
- * Add or remove a custom node from favorites.
- * Scope: custom_nodes:manage
- */
 export const favoriteCustomNodeTool = {
     name: 'favorite_custom_node',
     description: 'Add or remove a custom node from your favorites.',
@@ -24,7 +18,6 @@ export const favoriteCustomNodeTool = {
 };
 export async function handleFavoriteCustomNode(api, args) {
     try {
-        // If favorite is not specified, default to true (add to favorites)
         const favorite = args.favorite !== undefined ? args.favorite : true;
         const result = await api.favoriteCustomNode(args.node_id, favorite);
         const lines = [
@@ -45,4 +38,3 @@ export async function handleFavoriteCustomNode(api, args) {
         };
     }
 }
-//# sourceMappingURL=favorite-custom-node.js.map

package/dist/tools/favorite-recipe.d.ts

@@ -1,13 +1,7 @@
-/**
- * favorite_recipe MCP Tool
- *
- * Add or remove a recipe from favorites.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const favoriteRecipeTool: Tool;
 export declare function handleFavoriteRecipe(api: FlowDotApiClient, args: {
     hash: string;
     favorite: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=favorite-recipe.d.ts.map

package/dist/tools/favorite-recipe.js

@@ -1,8 +1,3 @@
-/**
- * favorite_recipe MCP Tool
- *
- * Add or remove a recipe from favorites.
- */
 export const favoriteRecipeTool = {
     name: 'favorite_recipe',
     description: 'Add or remove a recipe from your favorites. Favorited recipes can be filtered in list_recipes.',
@@ -30,8 +25,8 @@ export async function handleFavoriteRecipe(api, args) {
             content: [
                 {
                     type: 'text',
-                    text: `${emoji} Recipe ${action} favorites!
-
+                    text: `${emoji} Recipe ${action} favorites!
+
 **Favorited:** ${result.is_favorited ? 'Yes' : 'No'}`,
                 },
             ],
@@ -50,4 +45,3 @@ export async function handleFavoriteRecipe(api, args) {
         };
     }
 }
-//# sourceMappingURL=favorite-recipe.js.map

package/dist/tools/favorite-workflow.d.ts

@@ -1,13 +1,7 @@
-/**
- * favorite_workflow MCP Tool
- *
- * Favorites or unfavorites a workflow.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const favoriteWorkflowTool: Tool;
 export declare function handleFavoriteWorkflow(api: FlowDotApiClient, args: {
     workflow_id: string;
     favorite: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=favorite-workflow.d.ts.map

package/dist/tools/favorite-workflow.js

@@ -1,8 +1,3 @@
-/**
- * favorite_workflow MCP Tool
- *
- * Favorites or unfavorites a workflow.
- */
 export const favoriteWorkflowTool = {
     name: 'favorite_workflow',
     description: 'Add or remove a workflow from your favorites. Favorited workflows can be filtered in list_workflows.',
@@ -23,7 +18,6 @@ export const favoriteWorkflowTool = {
 };
 export async function handleFavoriteWorkflow(api, args) {
     try {
-        // API may return undefined (no data wrapper) or { message: "..." }
         const result = await api.favoriteWorkflow(args.workflow_id, args.favorite);
         const action = args.favorite ? 'added to' : 'removed from';
         const message = result?.message || `Workflow ${action} favorites.`;
@@ -39,4 +33,3 @@ export async function handleFavoriteWorkflow(api, args) {
         };
     }
 }
-//# sourceMappingURL=favorite-workflow.js.map

package/dist/tools/fork-recipe.d.ts

@@ -1,13 +1,7 @@
-/**
- * fork_recipe MCP Tool
- *
- * Creates a copy of a public recipe.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const forkRecipeTool: Tool;
 export declare function handleForkRecipe(api: FlowDotApiClient, args: {
     hash: string;
     name?: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=fork-recipe.d.ts.map

package/dist/tools/fork-recipe.js

@@ -1,8 +1,3 @@
-/**
- * fork_recipe MCP Tool
- *
- * Creates a copy of a public recipe.
- */
 export const forkRecipeTool = {
     name: 'fork_recipe',
     description: 'Create a copy of a public recipe into your account. The copy will be private and editable.',
@@ -28,13 +23,13 @@ export async function handleForkRecipe(api, args) {
             content: [
                 {
                     type: 'text',
-                    text: `Recipe forked successfully!
-
-**New Name:** ${result.name}
-**New Hash:** ${result.hash}
-**Forked From:** ${result.forked_from.name} by ${result.forked_from.user_name}
-**Visibility:** Private
-
+                    text: `Recipe forked successfully!
+
+**New Name:** ${result.name}
+**New Hash:** ${result.hash}
+**Forked From:** ${result.forked_from.name} by ${result.forked_from.user_name}
+**Visibility:** Private
+
 You can now edit this recipe and customize it for your needs.`,
                 },
             ],
@@ -53,4 +48,3 @@ You can now edit this recipe and customize it for your needs.`,
         };
     }
 }
-//# sourceMappingURL=fork-recipe.js.map

package/dist/tools/get-app-file.d.ts

@@ -1,11 +1,4 @@
-/**
- * get_app_file Tool
- *
- * Get a specific file from a multi-file FlowDot app.
- * Required scope: apps:read
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
 export declare const getAppFileTool: Tool;
 export declare function handleGetAppFile(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
-//# sourceMappingURL=get-app-file.d.ts.map