@flowdot.ai/mcp-server 1.0.4 → 1.0.5

package/dist/server.d.ts

@@ -1,15 +1,3 @@
-/**
- * FlowDot MCP Server
- *
- * Creates and configures the MCP server instance.
- */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-/**
- * Create and configure the FlowDot MCP server.
- */
 export declare function createServer(): Promise<Server>;
-/**
- * Start the MCP server with stdio transport.
- */
 export declare function startServer(): Promise<void>;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.js

@@ -1,22 +1,12 @@
-/**
- * FlowDot MCP Server
- *
- * Creates and configures the MCP server instance.
- */
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { FlowDotApiClient } from './api-client.js';
 import { registerTools } from './tools/index.js';
 import { registerResources } from './resources/index.js';
 const MCP_TOKEN_PREFIX = 'fd_mcp_';
-/**
- * Create and configure the FlowDot MCP server.
- */
 export async function createServer() {
-    // Get configuration from environment
     const apiToken = process.env.FLOWDOT_API_TOKEN;
     const hubUrl = process.env.FLOWDOT_HUB_URL || 'https://flowdot.ai';
-    // Validate token
     if (!apiToken) {
         console.error('Error: FLOWDOT_API_TOKEN environment variable is required.');
         console.error('');
@@ -27,7 +17,6 @@ export async function createServer() {
         console.error('');
         process.exit(1);
     }
-    // Validate token format
     if (!apiToken.startsWith(MCP_TOKEN_PREFIX)) {
         console.error(`Error: Invalid token format. Token must start with "${MCP_TOKEN_PREFIX}".`);
         console.error('');
@@ -36,10 +25,8 @@ export async function createServer() {
         console.error('');
         process.exit(1);
     }
-    // Create API client
     const internalSecret = process.env.INTERNAL_API_SECRET;
     const apiClient = new FlowDotApiClient(hubUrl, apiToken, internalSecret);
-    // Test connection
     console.error(`FlowDot MCP Server connecting to ${hubUrl}...`);
     const connected = await apiClient.testConnection();
     if (!connected) {
@@ -50,7 +37,6 @@ export async function createServer() {
     else {
         console.error('Connection verified successfully.');
     }
-    // Create MCP server with icon
     const server = new Server({
         name: 'flowdot',
         version: '1.0.0',
@@ -59,7 +45,6 @@ export async function createServer() {
         websiteUrl: 'https://flowdot.ai',
         icons: [
             {
-                // FlowDot icon as embedded PNG data URI (universally compatible, no network required)
                 src: 'data:image/png;base64,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',
                 mimeType: 'image/png',
                 sizes: ['32x32'],
@@ -70,10 +55,31 @@ export async function createServer() {
             tools: {},
             resources: {},
         },
+        instructions: `# FlowDot MCP — Start Here
+
+**READ THIS FIRST.** Before using any FlowDot tool, you should read the FlowDot learning resources. They are **MCP resources** (not tools), so they won't appear in your tool list — you must fetch them explicitly via the MCP resource-read mechanism (URIs below).
+
+## The 7 Learning Resources
+
+FlowDot exposes 7 \`learn://\` resources that explain every major feature of the platform. Each is a complete guide with concepts, tool reference, and worked examples. Read the one that matches the user's task *before* calling tools in that area.
+
+1. **\`learn://overview\`** — High-level overview of all FlowDot components and how they work together. Start here if you don't know where to start.
+2. **\`learn://workflows\`** — Complete guide to creating, managing, and executing FlowDot workflows (visual node-and-connection automations). Read before using \`create_workflow\`, \`add_node\`, \`add_connection\`, \`execute_workflow\`, etc.
+3. **\`learn://recipes\`** — Complete guide to agent recipes — orchestration workflows for complex automation (agent, parallel, loop, gate, branch, invoke steps). Read before using \`create_recipe\`, \`add_recipe_step\`, \`add_recipe_store\`, \`link_recipe\`, etc.
+4. **\`learn://custom-nodes\`** — Complete guide to creating and managing custom nodes (reusable JavaScript nodes with optional LLM calls). Read before using \`create_custom_node\`, \`update_custom_node\`, etc.
+5. **\`learn://apps\`** — Complete guide to building multi-file React applications with FlowDot (sandboxed frontends that can invoke workflows). Read before using \`create_app\`, \`create_app_file\`, \`edit_app_code\`, etc.
+6. **\`learn://toolkits\`** — Complete guide to creating and managing MCP agent toolkits (extend agents with new tools, credential-scoped). Read before using any \`mcp__flowdot__*toolkit*\` tool.
+7. **\`learn://knowledge-base\`** — Complete guide to using the FlowDot knowledge base with RAG (document upload, categories, semantic search). Read before using \`upload_text_document\`, \`query_knowledge_base\`, \`create_knowledge_category\`, etc.
+
+## How to Read a Learning Resource
+
+Use your MCP client's resource-read capability on the URI (e.g. \`learn://recipes\`). In Claude this is the \`ReadMcpResourceTool\` — pass \`server: "flowdot"\` and \`uri: "learn://recipes"\`. You can also list all resources via \`ListMcpResourcesTool\` to confirm they're available.
+
+## Rule of Thumb
+
+If the user asks about a FlowDot feature area you haven't touched in this session, **read the matching \`learn://\` resource before calling tools in that area.** These guides are the ground truth and will save you from guessing at schemas, step types, store conventions, and sandbox rules.`,
     });
-    // Register tools
     registerTools(server, apiClient);
-    // Register learning resources
     registerResources(server);
     console.error('FlowDot MCP Server initialized.');
     console.error('');
@@ -93,13 +99,9 @@ export async function createServer() {
     console.error('');
     return server;
 }
-/**
- * Start the MCP server with stdio transport.
- */
 export async function startServer() {
     const server = await createServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error('FlowDot MCP Server running on stdio.');
 }
-//# sourceMappingURL=server.js.map

package/dist/tools/add-connection.d.ts

@@ -1,10 +1,5 @@
-/**
- * add_connection MCP Tool
- *
- * Adds a connection between two nodes.
- */
-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 addConnectionTool: Tool;
 export declare function handleAddConnection(api: FlowDotApiClient, args: {
     workflow_id: string;
@@ -13,4 +8,3 @@ export declare function handleAddConnection(api: FlowDotApiClient, args: {
     target_node_id: string;
     target_socket_id: string;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-connection.d.ts.map

package/dist/tools/add-connection.js

@@ -1,8 +1,3 @@
-/**
- * add_connection MCP Tool
- *
- * Adds a connection between two nodes.
- */
 export const addConnectionTool = {
     name: 'add_connection',
     description: 'Create a connection between two nodes in a workflow. Connects an output socket to an input socket.',
@@ -59,4 +54,3 @@ export async function handleAddConnection(api, args) {
         };
     }
 }
-//# sourceMappingURL=add-connection.js.map

package/dist/tools/add-custom-node-comment.d.ts

@@ -1,15 +1,8 @@
-/**
- * add_custom_node_comment MCP Tool
- *
- * Add a comment to a custom node.
- * 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 addCustomNodeCommentTool: Tool;
 export declare function handleAddCustomNodeComment(api: FlowDotApiClient, args: {
     node_id: string;
     content: string;
     parent_id?: number;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-custom-node-comment.d.ts.map

package/dist/tools/add-custom-node-comment.js

@@ -1,9 +1,3 @@
-/**
- * add_custom_node_comment MCP Tool
- *
- * Add a comment to a custom node.
- * Scope: custom_nodes:manage
- */
 export const addCustomNodeCommentTool = {
     name: 'add_custom_node_comment',
     description: 'Add a comment to a custom node. Can also be used to reply to existing comments.',
@@ -66,4 +60,3 @@ export async function handleAddCustomNodeComment(api, args) {
         };
     }
 }
-//# sourceMappingURL=add-custom-node-comment.js.map

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

@@ -1,10 +1,5 @@
-/**
- * add_node MCP Tool
- *
- * Adds a new node to 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 addNodeTool: Tool;
 export declare function handleAddNode(api: FlowDotApiClient, args: {
     workflow_id: string;
@@ -15,4 +10,3 @@ export declare function handleAddNode(api: FlowDotApiClient, args: {
     };
     properties?: Record<string, unknown>;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-node.d.ts.map

package/dist/tools/add-node.js

@@ -1,8 +1,3 @@
-/**
- * add_node MCP Tool
- *
- * Adds a new node to a workflow.
- */
 export const addNodeTool = {
     name: 'add_node',
     description: 'Add a new node to a workflow. Supports both built-in nodes and custom nodes. For custom nodes, use the format "custom_node_{hash}" where {hash} is the custom node ID.',
@@ -63,4 +58,3 @@ export async function handleAddNode(api, args) {
         };
     }
 }
-//# sourceMappingURL=add-node.js.map

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

@@ -1,11 +1,6 @@
-/**
- * add_recipe_step MCP Tool
- *
- * Adds a new step to a recipe.
- */
-import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import { FlowDotApiClient } from '../api-client.js';
-import { RecipeStepType } from '../types.js';
+import type { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { FlowDotApiClient } from '../api-client.js';
+import type { RecipeStepType } from '../types.js';
 export declare const addRecipeStepTool: Tool;
 export declare function handleAddRecipeStep(api: FlowDotApiClient, args: {
     hash: string;
@@ -20,4 +15,3 @@ export declare function handleAddRecipeStep(api: FlowDotApiClient, args: {
         y: number;
     };
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-recipe-step.d.ts.map

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

@@ -1,59 +1,54 @@
-/**
- * add_recipe_step MCP Tool
- *
- * Adds a new step to a recipe.
- */
 export const addRecipeStepTool = {
     name: 'add_recipe_step',
-    description: `Add a new step to a recipe. **Save the returned step ID** for connections.
-
-**Step Types & Config:**
-
-**agent** - LLM agent with tools
-\`\`\`json
-{ "user_prompt": "Instructions with {{inputs.request}} and {{store_key}}", "tools": ["read", "search", "web-search"], "output_store": "result_key", "max_iterations": 10 }
-\`\`\`
-**IMPORTANT:** Use \`user_prompt\` (NOT \`prompt\`) - this is the field the runtime expects.
-Tools: read, search, analyze, find-definition, web-search, edit, execute-command, create-file
-
-**parallel** - Run steps concurrently
-\`\`\`json
-{ "parallel_step_ids": ["step-id-1", "step-id-2"] }
-\`\`\`
-
-**loop** - Iterate over array
-\`\`\`json
-{ "loop_over": "array_store_key", "loop_variable": "current_item_key", "loop_step_id": "step-id-to-run", "parallel": true, "max_concurrent": 5 }
-\`\`\`
-Set \`parallel: true\` to execute iterations concurrently. Use \`max_concurrent\` to limit simultaneous executions.
-
-**gate** - Approval, condition check, or user input collection
-\`\`\`json
-{ "requires_approval": true, "approval_prompt": "Review: {{data}}", "condition": "{{status}} === 'ready'", "input_options": { "button_mode": "preset", "preset": "approve_deny" }, "input_output_store": "decision" }
-\`\`\`
-**Gate Input Options** (for rich user input):
-- \`input_options.button_mode\`: "preset" or "custom"
-- \`input_options.preset\`: "approve_deny", "yes_no", or "continue_cancel"
-- \`input_options.buttons\`: Array of { label, value, isApproval, style } for custom buttons
-- \`input_options.allow_comment\`: Enable text input field
-- \`input_options.comment_required\`: Require text input
-- \`input_options.comment_placeholder\`: Placeholder text
-- \`input_output_store\`: Store key to save user response { action, comment, timestamp, timedOut }
-
-**branch** - Conditional routing
-\`\`\`json
-{ "conditions": [{"expression": "{{x}} === 'a'", "then": "step-a"}], "default": "step-default" }
-\`\`\`
-
-**invoke** - Call another recipe
-\`\`\`json
-{ "recipe_hash": "xyz", "input_mapping": {"target_input": "{{source_store}}"}, "output_mapping": {"target_output": "local_store"} }
-\`\`\`
-
-**Interpolation Syntax:**
-- \`{{inputs.request}}\` - Access CLI task argument (user runs: \`flowdot alias "task text"\`)
-- \`{{store_key}}\` - Reference any store value by its key
-- \`{{stores.store_key}}\` - Explicit store access (same as above)
+    description: `Add a new step to a recipe. **Save the returned step ID** for connections.
+
+**Step Types & Config:**
+
+**agent** - LLM agent with tools
+\`\`\`json
+{ "user_prompt": "Instructions with {{inputs.request}} and {{store_key}}", "tools": ["read", "search", "web-search"], "output_store": "result_key", "max_iterations": 10 }
+\`\`\`
+**IMPORTANT:** Use \`user_prompt\` (NOT \`prompt\`) - this is the field the runtime expects.
+Tools: read, search, analyze, find-definition, web-search, edit, execute-command, create-file
+
+**parallel** - Run steps concurrently
+\`\`\`json
+{ "parallel_step_ids": ["step-id-1", "step-id-2"] }
+\`\`\`
+
+**loop** - Iterate over array
+\`\`\`json
+{ "loop_over": "array_store_key", "loop_variable": "current_item_key", "loop_step_id": "step-id-to-run", "parallel": true, "max_concurrent": 5 }
+\`\`\`
+Set \`parallel: true\` to execute iterations concurrently. Use \`max_concurrent\` to limit simultaneous executions.
+
+**gate** - Approval, condition check, or user input collection
+\`\`\`json
+{ "requires_approval": true, "approval_prompt": "Review: {{data}}", "condition": "{{status}} === 'ready'", "input_options": { "button_mode": "preset", "preset": "approve_deny" }, "input_output_store": "decision" }
+\`\`\`
+**Gate Input Options** (for rich user input):
+- \`input_options.button_mode\`: "preset" or "custom"
+- \`input_options.preset\`: "approve_deny", "yes_no", or "continue_cancel"
+- \`input_options.buttons\`: Array of { label, value, isApproval, style } for custom buttons
+- \`input_options.allow_comment\`: Enable text input field
+- \`input_options.comment_required\`: Require text input
+- \`input_options.comment_placeholder\`: Placeholder text
+- \`input_output_store\`: Store key to save user response { action, comment, timestamp, timedOut }
+
+**branch** - Conditional routing
+\`\`\`json
+{ "conditions": [{"expression": "{{x}} === 'a'", "then": "step-a"}], "default": "step-default" }
+\`\`\`
+
+**invoke** - Call another recipe
+\`\`\`json
+{ "recipe_hash": "xyz", "input_mapping": {"target_input": "{{source_store}}"}, "output_mapping": {"target_output": "local_store"} }
+\`\`\`
+
+**Interpolation Syntax:**
+- \`{{inputs.request}}\` - Access CLI task argument (user runs: \`flowdot alias "task text"\`)
+- \`{{store_key}}\` - Reference any store value by its key
+- \`{{stores.store_key}}\` - Explicit store access (same as above)
 - \`{{step.step_id}}\` - Access output from a previous step`,
     inputSchema: {
         type: 'object',
@@ -114,67 +109,67 @@ export async function handleAddRecipeStep(api, args) {
         const step = await api.addRecipeStep(args.hash, input);
         let configInfo = '';
         if (args.type === 'agent') {
-            configInfo = `
-
-**Agent Configuration:**
-Set the config object with:
-- \`user_prompt\`: The prompt for the agent (REQUIRED - use this, NOT \`prompt\`)
-- \`system_prompt\`: Optional system-level instructions
-- \`model_tier\`: LLM model tier: "simple", "capable", or "complex" (optional)
-- \`tools\`: Array of tool names to make available
-- \`output_store\`: Store key to write agent output to
-- \`max_iterations\`: Maximum iterations for the agent
-
-**Interpolation in prompts:**
-- Use \`{{inputs.request}}\` to access the CLI task argument
+            configInfo = `
+
+**Agent Configuration:**
+Set the config object with:
+- \`user_prompt\`: The prompt for the agent (REQUIRED - use this, NOT \`prompt\`)
+- \`system_prompt\`: Optional system-level instructions
+- \`model_tier\`: LLM model tier: "simple", "capable", or "complex" (optional)
+- \`tools\`: Array of tool names to make available
+- \`output_store\`: Store key to write agent output to
+- \`max_iterations\`: Maximum iterations for the agent
+
+**Interpolation in prompts:**
+- Use \`{{inputs.request}}\` to access the CLI task argument
 - Use \`{{store_key}}\` to reference store values`;
         }
         else if (args.type === 'loop') {
-            configInfo = `
-
-**Loop Configuration:**
-Set the config object with:
-- \`loop_over\`: Store key containing the array to iterate over
-- \`loop_variable\`: Store key to put each item in
-- \`loop_step_id\`: Step ID to run for each iteration
-- \`parallel\`: (optional) Execute iterations concurrently (default: false)
+            configInfo = `
+
+**Loop Configuration:**
+Set the config object with:
+- \`loop_over\`: Store key containing the array to iterate over
+- \`loop_variable\`: Store key to put each item in
+- \`loop_step_id\`: Step ID to run for each iteration
+- \`parallel\`: (optional) Execute iterations concurrently (default: false)
 - \`max_concurrent\`: (optional) Limit concurrent executions when parallel=true`;
         }
         else if (args.type === 'branch') {
-            configInfo = `
-
-**Branch Configuration:**
-Set the config object with:
-- \`conditions\`: Array of { expression, then } objects
+            configInfo = `
+
+**Branch Configuration:**
+Set the config object with:
+- \`conditions\`: Array of { expression, then } objects
 - \`default\`: Step ID if no conditions match`;
         }
         else if (args.type === 'gate') {
-            configInfo = `
-
-**Gate Configuration:**
-Set the config object with:
-- \`requires_approval\`: Boolean to require user input
-- \`approval_prompt\`: Message to show the user
-- \`condition\`: Optional expression to evaluate
-- \`input_options\`: Rich input configuration object:
-  - \`button_mode\`: "preset" or "custom"
-  - \`preset\`: "approve_deny", "yes_no", or "continue_cancel"
-  - \`buttons\`: Array of { label, value, isApproval, style } for custom options
-  - \`allow_comment\`: Enable text input field
-  - \`comment_required\`: Require text input
-  - \`comment_placeholder\`: Placeholder text
+            configInfo = `
+
+**Gate Configuration:**
+Set the config object with:
+- \`requires_approval\`: Boolean to require user input
+- \`approval_prompt\`: Message to show the user
+- \`condition\`: Optional expression to evaluate
+- \`input_options\`: Rich input configuration object:
+  - \`button_mode\`: "preset" or "custom"
+  - \`preset\`: "approve_deny", "yes_no", or "continue_cancel"
+  - \`buttons\`: Array of { label, value, isApproval, style } for custom options
+  - \`allow_comment\`: Enable text input field
+  - \`comment_required\`: Require text input
+  - \`comment_placeholder\`: Placeholder text
 - \`input_output_store\`: Store key to save { action, comment, timestamp, timedOut }`;
         }
         return {
             content: [
                 {
                     type: 'text',
-                    text: `Step added successfully!
-
-**Name:** ${step.name}
-**Type:** ${step.type}
-**ID:** ${step.id}
-**Next:** ${step.next || 'None'}
+                    text: `Step added successfully!
+
+**Name:** ${step.name}
+**Type:** ${step.type}
+**ID:** ${step.id}
+**Next:** ${step.next || 'None'}
 **On Error:** ${step.on_error || 'None'}${configInfo}`,
                 },
             ],
@@ -193,4 +188,3 @@ Set the config object with:
         };
     }
 }
-//# sourceMappingURL=add-recipe-step.js.map

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

@@ -1,10 +1,5 @@
-/**
- * add_recipe_store MCP Tool
- *
- * Adds a new store (variable) to 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 addRecipeStoreTool: Tool;
 export declare function handleAddRecipeStore(api: FlowDotApiClient, args: {
     hash: string;
@@ -16,4 +11,3 @@ export declare function handleAddRecipeStore(api: FlowDotApiClient, args: {
     is_input?: boolean;
     is_output?: boolean;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-recipe-store.d.ts.map

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

@@ -1,33 +1,28 @@
-/**
- * add_recipe_store MCP Tool
- *
- * Adds a new store (variable) to a recipe.
- */
 export const addRecipeStoreTool = {
     name: 'add_recipe_store',
-    description: `Add a new store (variable) to a recipe. Stores hold data that flows between steps.
-
-**Store Types:**
-- **Input stores** (is_input: true): Values user provides when running
-- **Output stores** (is_output: true): Values returned after execution
-- **Internal stores**: Temporary values used during execution
-
-**IMPORTANT - The \`request\` Convention:**
-When users run a recipe with a task argument like:
-\`flowdot my-recipe "do something"\`
-
-The CLI passes this as \`inputs.request\`. Therefore:
-- **Name your primary input store \`request\`** to receive the task directly
-- In prompts, use \`{{inputs.request}}\` to access the CLI task argument
-- Example: \`add_recipe_store(key: "request", is_input: true)\`
-
-**Using Stores in Steps:**
-Reference stores in agent prompts, conditions, and mappings with \`{{store_key}}\` syntax:
-- Agent prompt: \`"Analyze {{topic}} and write to {{output}}"\`
-- Branch condition: \`"{{severity}} === 'high'"\`
-- Gate approval: \`"Review findings:\\n{{findings}}"\`
-
-**Agent Output:**
+    description: `Add a new store (variable) to a recipe. Stores hold data that flows between steps.
+
+**Store Types:**
+- **Input stores** (is_input: true): Values user provides when running
+- **Output stores** (is_output: true): Values returned after execution
+- **Internal stores**: Temporary values used during execution
+
+**IMPORTANT - The \`request\` Convention:**
+When users run a recipe with a task argument like:
+\`flowdot my-recipe "do something"\`
+
+The CLI passes this as \`inputs.request\`. Therefore:
+- **Name your primary input store \`request\`** to receive the task directly
+- In prompts, use \`{{inputs.request}}\` to access the CLI task argument
+- Example: \`add_recipe_store(key: "request", is_input: true)\`
+
+**Using Stores in Steps:**
+Reference stores in agent prompts, conditions, and mappings with \`{{store_key}}\` syntax:
+- Agent prompt: \`"Analyze {{topic}} and write to {{output}}"\`
+- Branch condition: \`"{{severity}} === 'high'"\`
+- Gate approval: \`"Review findings:\\n{{findings}}"\`
+
+**Agent Output:**
 Set \`output_store\` in agent config to write results to a store.`,
     inputSchema: {
         type: 'object',
@@ -88,13 +83,13 @@ export async function handleAddRecipeStore(api, args) {
             content: [
                 {
                     type: 'text',
-                    text: `Store added successfully!
-
-**Key:** ${store.key}
-**Type:** ${storeType} (${store.schema_type})
-**ID:** ${store.id}
-**Default Value:** ${store.default_value !== undefined ? JSON.stringify(store.default_value) : 'None'}
-
+                    text: `Store added successfully!
+
+**Key:** ${store.key}
+**Type:** ${storeType} (${store.schema_type})
+**ID:** ${store.id}
+**Default Value:** ${store.default_value !== undefined ? JSON.stringify(store.default_value) : 'None'}
+
 Use this store in expressions with: \`{{${store.key}}}\``,
                 },
             ],
@@ -113,4 +108,3 @@ Use this store in expressions with: \`{{${store.key}}}\``,
         };
     }
 }
-//# sourceMappingURL=add-recipe-store.js.map

package/dist/tools/add-shared-result-comment.d.ts

@@ -1,10 +1,5 @@
-/**
- * add_shared_result_comment MCP Tool
- *
- * Adds a comment to a shared execution result.
- */
-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 addSharedResultCommentTool: Tool;
 export declare function handleAddSharedResultComment(api: FlowDotApiClient, args: {
     workflow_id: string;
@@ -12,4 +7,3 @@ export declare function handleAddSharedResultComment(api: FlowDotApiClient, args
     content: string;
     parent_id?: number;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-shared-result-comment.d.ts.map

package/dist/tools/add-shared-result-comment.js

@@ -1,8 +1,3 @@
-/**
- * add_shared_result_comment MCP Tool
- *
- * Adds a comment to a shared execution result.
- */
 export const addSharedResultCommentTool = {
     name: 'add_shared_result_comment',
     description: 'Add a comment to a shared execution result.',
@@ -31,7 +26,6 @@ export const addSharedResultCommentTool = {
 };
 export async function handleAddSharedResultComment(api, args) {
     try {
-        // Validate content length
         if (!args.content || args.content.trim().length === 0) {
             return {
                 content: [{ type: 'text', text: 'Error: Comment content cannot be empty.' }],
@@ -67,4 +61,3 @@ export async function handleAddSharedResultComment(api, args) {
         };
     }
 }
-//# sourceMappingURL=add-shared-result-comment.js.map

package/dist/tools/add-workflow-comment.d.ts

@@ -1,14 +1,8 @@
-/**
- * add_workflow_comment MCP Tool
- *
- * Adds a comment to 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 addWorkflowCommentTool: Tool;
 export declare function handleAddWorkflowComment(api: FlowDotApiClient, args: {
     workflow_id: string;
     content: string;
     parent_id?: number;
 }): Promise<CallToolResult>;
-//# sourceMappingURL=add-workflow-comment.d.ts.map

package/dist/tools/add-workflow-comment.js

@@ -1,8 +1,3 @@
-/**
- * add_workflow_comment MCP Tool
- *
- * Adds a comment to a workflow.
- */
 export const addWorkflowCommentTool = {
     name: 'add_workflow_comment',
     description: 'Add a comment to a workflow. You can only comment on public workflows or your own workflows.',
@@ -27,7 +22,6 @@ export const addWorkflowCommentTool = {
 };
 export async function handleAddWorkflowComment(api, args) {
     try {
-        // Validate content length
         if (!args.content || args.content.trim().length === 0) {
             return {
                 content: [{ type: 'text', text: 'Error: Comment content cannot be empty.' }],
@@ -63,4 +57,3 @@ export async function handleAddWorkflowComment(api, args) {
         };
     }
 }
-//# sourceMappingURL=add-workflow-comment.js.map