@flowdot.ai/mcp-server 1.0.0

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

@@ -0,0 +1,66 @@
+/**
+ * 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.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            workflow_id: {
+                type: 'string',
+                description: 'The workflow ID (hash)',
+            },
+            content: {
+                type: 'string',
+                description: 'The comment content (max 2000 characters)',
+            },
+            parent_id: {
+                type: 'number',
+                description: 'Optional parent comment ID for replies',
+            },
+        },
+        required: ['workflow_id', 'content'],
+    },
+};
+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.' }],
+                isError: true,
+            };
+        }
+        if (args.content.length > 2000) {
+            return {
+                content: [{ type: 'text', text: 'Error: Comment content exceeds maximum length of 2000 characters.' }],
+                isError: true,
+            };
+        }
+        const result = await api.addWorkflowComment(args.workflow_id, args.content, args.parent_id);
+        const isReply = args.parent_id ? ' (reply)' : '';
+        const lines = [
+            `## Comment Added Successfully${isReply}`,
+            '',
+            `**Comment ID:** ${result.id}`,
+            `**By:** ${result.user_name}`,
+            `**Posted:** ${result.created_at}`,
+            '',
+            '> ' + result.content.split('\n').join('\n> '),
+        ];
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error adding comment: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=add-workflow-comment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-workflow-comment.js","sourceRoot":"","sources":["../../src/tools/add-workflow-comment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,sBAAsB,GAAS;IAC1C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,8FAA8F;IAC3G,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;aACzD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,EAAE,SAAS,CAAC;KACrC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAqB,EACrB,IAAkE;IAElE,IAAI,CAAC;QACH,0BAA0B;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC;gBAC5E,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC/B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mEAAmE,EAAE,CAAC;gBACtG,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,kBAAkB,CACzC,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG;YACZ,gCAAgC,OAAO,EAAE;YACzC,EAAE;YACF,mBAAmB,MAAM,CAAC,EAAE,EAAE;YAC9B,WAAW,MAAM,CAAC,SAAS,EAAE;YAC7B,eAAe,MAAM,CAAC,UAAU,EAAE;YAClC,EAAE;YACF,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;SAC/C,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,OAAO,EAAE,EAAE,CAAC;YACrE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/agent-chat.d.ts

@@ -0,0 +1,14 @@
+/**
+ * agent_chat MCP Tool
+ *
+ * Chat with the FlowDot agent to discover and run workflows.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const agentChatTool: Tool;
+export declare function handleAgentChat(api: FlowDotApiClient, args: {
+    message: string;
+    conversation_id?: string;
+    mode?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=agent-chat.d.ts.map

package/dist/tools/agent-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat.d.ts","sourceRoot":"","sources":["../../src/tools/agent-chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,aAAa,EAAE,IAwB3B,CAAC;AAEF,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE,OAAO,CAAC,cAAc,CAAC,CAqDzB"}

package/dist/tools/agent-chat.js

@@ -0,0 +1,80 @@
+/**
+ * agent_chat MCP Tool
+ *
+ * Chat with the FlowDot agent to discover and run workflows.
+ */
+export const agentChatTool = {
+    name: 'agent_chat',
+    description: 'Chat with the FlowDot AI agent. The agent can help discover workflows, suggest which workflow to run, and explain workflow capabilities.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            message: {
+                type: 'string',
+                description: 'Message to send to the FlowDot agent',
+            },
+            conversation_id: {
+                type: 'string',
+                description: 'Optional conversation ID to continue a previous conversation',
+            },
+            mode: {
+                type: 'string',
+                enum: ['flowdot', 'simple', 'capable', 'complex'],
+                description: 'LLM mode to use: flowdot (default, cost-effective), simple (fast), capable (balanced), complex (powerful)',
+                default: 'flowdot',
+            },
+        },
+        required: ['message'],
+    },
+};
+export async function handleAgentChat(api, args) {
+    try {
+        // API returns { response, conversation_id, suggested_workflows }
+        const mode = args.mode || 'flowdot';
+        const result = await api.agentChat(args.message, args.conversation_id, mode);
+        // Handle case where result is undefined or missing response
+        const response = result?.response;
+        if (!response) {
+            return {
+                content: [{ type: 'text', text: 'Agent returned an empty response.' }],
+            };
+        }
+        let text = response;
+        // Add suggested workflows if any
+        const suggestedWorkflows = Array.isArray(result?.suggested_workflows) ? result.suggested_workflows : [];
+        if (suggestedWorkflows.length > 0) {
+            text += '\n\nSuggested workflows:\n';
+            text += suggestedWorkflows
+                .map((w) => {
+                const desc = w.description ? ` - ${w.description}` : '';
+                return `- **${w.name}** (${w.id})${desc}`;
+            })
+                .join('\n');
+        }
+        // Add conversation ID if available (for continuing the conversation)
+        if (result?.conversation_id) {
+            text += `\n\n_Conversation ID: ${result.conversation_id}_`;
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error chatting with agent: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=agent-chat.js.map

package/dist/tools/agent-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-chat.js","sourceRoot":"","sources":["../../src/tools/agent-chat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,0IAA0I;IAC5I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;gBACjD,WAAW,EAAE,2GAA2G;gBACxH,OAAO,EAAE,SAAS;aACnB;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAqB,EACrB,IAAkE;IAElE,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;QACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAE7E,4DAA4D;QAC5D,MAAM,QAAQ,GAAG,MAAM,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,GAAG,QAAQ,CAAC;QAEpB,iCAAiC;QACjC,MAAM,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,IAAI,4BAA4B,CAAC;YACrC,IAAI,IAAI,kBAAkB;iBACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxD,OAAO,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YAC5C,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QAED,qEAAqE;QACrE,IAAI,MAAM,EAAE,eAAe,EAAE,CAAC;YAC5B,IAAI,IAAI,yBAAyB,MAAM,CAAC,eAAe,GAAG,CAAC;QAC7D,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI;iBACL;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,8BAA8B,OAAO,EAAE;iBAC9C;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/cancel-execution.d.ts

@@ -0,0 +1,12 @@
+/**
+ * cancel_execution MCP Tool
+ *
+ * Cancels a running workflow execution.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const cancelExecutionTool: Tool;
+export declare function handleCancelExecution(api: FlowDotApiClient, args: {
+    execution_id: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=cancel-execution.d.ts.map

package/dist/tools/cancel-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-execution.d.ts","sourceRoot":"","sources":["../../src/tools/cancel-execution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,EAAE,IAajC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,cAAc,CAAC,CAiBzB"}

package/dist/tools/cancel-execution.js

@@ -0,0 +1,37 @@
+/**
+ * cancel_execution MCP Tool
+ *
+ * Cancels a running workflow execution.
+ */
+export const cancelExecutionTool = {
+    name: 'cancel_execution',
+    description: 'Cancel a running workflow execution. Only works on executions with status "running" or "pending".',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            execution_id: {
+                type: 'string',
+                description: 'The execution ID to cancel',
+            },
+        },
+        required: ['execution_id'],
+    },
+};
+export async function handleCancelExecution(api, args) {
+    try {
+        // API may return undefined (no data wrapper) or { message: "..." }
+        const result = await api.cancelExecution(args.execution_id);
+        const message = result?.message || `Execution ${args.execution_id} has been cancelled.`;
+        return {
+            content: [{ type: 'text', text: message }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error cancelling execution: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=cancel-execution.js.map

package/dist/tools/cancel-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-execution.js","sourceRoot":"","sources":["../../src/tools/cancel-execution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,mGAAmG;IAChH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,CAAC;KAC3B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAqB,EACrB,IAA8B;IAE9B,IAAI,CAAC;QACH,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE5D,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,aAAa,IAAI,CAAC,YAAY,sBAAsB,CAAC;QAExF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;SAC3C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,OAAO,EAAE,EAAE,CAAC;YAC3E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/clone-app.d.ts

@@ -0,0 +1,11 @@
+/**
+ * clone_app Tool
+ *
+ * Clone a public app to your library.
+ * Required scope: apps:manage
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const cloneAppTool: Tool;
+export declare function handleCloneApp(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=clone-app.d.ts.map

package/dist/tools/clone-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-app.d.ts","sourceRoot":"","sources":["../../src/tools/clone-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,IAuB1B,CAAC;AAEF,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAiCzB"}

package/dist/tools/clone-app.js

@@ -0,0 +1,63 @@
+/**
+ * clone_app Tool
+ *
+ * Clone a public app to your library.
+ * Required scope: apps:manage
+ */
+export const cloneAppTool = {
+    name: 'clone_app',
+    description: `Clone a public app to your library. Creates a private copy that you can customize.
+
+The cloned app will:
+- Be owned by you
+- Start as private (not published)
+- Have all the original code and configuration
+- Not include linked workflows (you'll need to link your own)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash) to clone',
+            },
+            name: {
+                type: 'string',
+                description: 'Name for the cloned app (defaults to "Original Name (Copy)")',
+            },
+        },
+        required: ['app_id'],
+    },
+};
+export async function handleCloneApp(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const name = args.name ? String(args.name) : undefined;
+        const result = await client.cloneApp(appId, name);
+        const text = `App cloned successfully!
+
+**New App ID:** ${result.id}
+**Name:** ${result.name}
+**Original App:** ${result.original_app_id}
+**Created:** ${result.created_at}
+
+## Next Steps
+
+1. **Link your workflows** - The cloned app doesn't include workflow links.
+   Use link_app_workflow to connect your own workflows.
+
+2. **Customize the code** - Use update_app to modify the React code.
+
+3. **Test and publish** - When ready, use publish_app to make it public.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error cloning app: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=clone-app.js.map

package/dist/tools/clone-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-app.js","sourceRoot":"","sources":["../../src/tools/clone-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE;;;;;;8DAM+C;IAC5D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAElD,MAAM,IAAI,GAAG;;kBAEC,MAAM,CAAC,EAAE;YACf,MAAM,CAAC,IAAI;oBACH,MAAM,CAAC,eAAe;eAC3B,MAAM,CAAC,UAAU;;;;;;;;;yEASyC,CAAC;QAEtE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC;YAClE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * copy_custom_node MCP Tool
+ *
+ * Copy a public custom node to your library.
+ * Scope: custom_nodes:manage
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const copyCustomNodeTool: Tool;
+export declare function handleCopyCustomNode(api: FlowDotApiClient, args: {
+    node_id: string;
+    name?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=copy-custom-node.d.ts.map

package/dist/tools/copy-custom-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-custom-node.d.ts","sourceRoot":"","sources":["../../src/tools/copy-custom-node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,EAAE,IAiBhC,CAAC;AAEF,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,cAAc,CAAC,CAyBzB"}

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

@@ -0,0 +1,50 @@
+/**
+ * copy_custom_node MCP Tool
+ *
+ * Copy a public custom node to your library.
+ * Scope: custom_nodes:manage
+ */
+export const copyCustomNodeTool = {
+    name: 'copy_custom_node',
+    description: 'Copy a public custom node to your library. The copy will be private by default.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            node_id: {
+                type: 'string',
+                description: 'The custom node ID (hash) to copy',
+            },
+            name: {
+                type: 'string',
+                description: 'Optional new name for the copy (defaults to original name with "(copy)" suffix)',
+            },
+        },
+        required: ['node_id'],
+    },
+};
+export async function handleCopyCustomNode(api, args) {
+    try {
+        const result = await api.copyCustomNode(args.node_id, args.name);
+        const lines = [
+            `## Custom Node Copied Successfully`,
+            ``,
+            `**New Node ID:** ${result.id}`,
+            `**Name:** ${result.name}`,
+            `**Created:** ${result.created_at}`,
+            ``,
+            `The node has been copied to your library as a private custom node.`,
+            `You can now edit and customize it as needed.`,
+        ];
+        return {
+            content: [{ type: 'text', text: lines.join('\n') }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error copying custom node: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=copy-custom-node.js.map

package/dist/tools/copy-custom-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-custom-node.js","sourceRoot":"","sources":["../../src/tools/copy-custom-node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,iFAAiF;IAC9F,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iFAAiF;aAC/F;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAqB,EACrB,IAAwC;IAExC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG;YACZ,oCAAoC;YACpC,EAAE;YACF,oBAAoB,MAAM,CAAC,EAAE,EAAE;YAC/B,aAAa,MAAM,CAAC,IAAI,EAAE;YAC1B,gBAAgB,MAAM,CAAC,UAAU,EAAE;YACnC,EAAE;YACF,oEAAoE;YACpE,8CAA8C;SAC/C,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SACpD,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8BAA8B,OAAO,EAAE,EAAE,CAAC;YAC1E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/create-app.d.ts

@@ -0,0 +1,11 @@
+/**
+ * create_app Tool
+ *
+ * Create a new FlowDot app.
+ * Required scope: apps:manage
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const createAppTool: Tool;
+export declare function handleCreateApp(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=create-app.d.ts.map

package/dist/tools/create-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app.d.ts","sourceRoot":"","sources":["../../src/tools/create-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,eAAO,MAAM,aAAa,EAAE,IAwF3B,CAAC;AAEF,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAiFzB"}

package/dist/tools/create-app.js

@@ -0,0 +1,182 @@
+/**
+ * create_app Tool
+ *
+ * Create a new FlowDot app.
+ * Required scope: apps:manage
+ */
+export const createAppTool = {
+    name: 'create_app',
+    description: `Create a new FlowDot app. Apps are React frontend applications that can optionally use workflows as backends.
+
+## EXECUTION ENVIRONMENT
+Apps run in a sandboxed browser iframe with:
+- React 18 (global - use React.useState, React.useEffect, etc.)
+- Tailwind CSS (full utility classes available)
+- FlowDot color tokens: primary-50 to primary-900 (sage green), secondary-50 to secondary-900 (warm orange)
+
+## CRITICAL CODE RULES
+1. NO IMPORTS - React is global, just use React.useState(), React.useEffect(), etc.
+2. NO EXPORTS - Just define your function, the system handles the rest
+3. Function must be named: function MyAppName() { ... }
+4. Use Tailwind CSS for ALL styling (no inline style objects, no CSS-in-JS)
+
+## DISPLAY MODES
+Apps can be configured to display in three modes via config.displayMode:
+- "windowed": Standard view with FlowDot header (default)
+- "fullscreen": Full viewport, minimal floating control bar
+- "embedded": No FlowDot UI, for iframe embedding
+
+## WORKFLOW INTEGRATION
+Apps can invoke linked workflows using: await invokeWorkflow('workflow-hash', { inputName: value })
+
+The function returns workflow results in this format:
+{
+  "data": {
+    "[nodeId]": {
+      "nodeId": "uuid",
+      "nodeTitle": "My Output Node",
+      "nodeType": "text_output",
+      "outputs": {
+        "Consolidated Text": { "value": "the actual data", "metadata": {...} }
+      }
+    }
+  }
+}
+
+IMPORTANT: Use this helper function to extract outputs by node title:
+const getNodeOutput = (result, nodeTitle, socketName = 'Consolidated Text') => {
+  const node = Object.values(result?.data || {}).find(n => n.nodeTitle === nodeTitle);
+  return node?.outputs?.[socketName]?.value;
+};
+
+Example: const weatherData = getNodeOutput(result, 'Weather Results', 'Consolidated Text');
+
+After creating an app, use link_app_workflow to connect workflows that the app can invoke.
+Use get_app_template to see example code and patterns.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name of the app',
+            },
+            description: {
+                type: 'string',
+                description: 'Description of what the app does',
+            },
+            code: {
+                type: 'string',
+                description: 'React code for the app (JSX/TSX)',
+            },
+            mobile_code: {
+                type: 'string',
+                description: 'Mobile-specific React code (optional)',
+            },
+            config: {
+                type: 'object',
+                description: 'Configuration object for the app (optional)',
+            },
+            category: {
+                type: 'string',
+                description: 'Category for the app (e.g., "productivity", "ai-tools", "utilities")',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Tags for discoverability (max 10)',
+            },
+            mobile_compatible: {
+                type: 'boolean',
+                description: 'Whether the app is mobile-compatible (default: false)',
+            },
+        },
+        required: ['name'],
+    },
+};
+export async function handleCreateApp(client, args) {
+    try {
+        const input = {
+            name: String(args.name),
+        };
+        if (args.description)
+            input.description = String(args.description);
+        if (args.code)
+            input.code = String(args.code);
+        if (args.mobile_code)
+            input.mobile_code = String(args.mobile_code);
+        if (args.config)
+            input.config = args.config;
+        if (args.category)
+            input.category = String(args.category);
+        if (args.tags)
+            input.tags = args.tags;
+        if (typeof args.mobile_compatible === 'boolean')
+            input.mobile_compatible = args.mobile_compatible;
+        const result = await client.createApp(input);
+        const text = `App created successfully!
+
+**Name:** ${result.name}
+**ID:** ${result.id}
+**Created:** ${result.created_at}
+
+## Next Steps
+
+1. **Add code** (if not provided):
+   Use update_app to add or modify the React code.
+
+2. **Link workflows**:
+   Use link_app_workflow to connect workflows that the app can invoke:
+   \`link_app_workflow(app_id: "${result.id}", workflow_hash: "YOUR_WORKFLOW_HASH")\`
+
+3. **Test locally**:
+   Preview your app in the FlowDot UI at https://flowdot.ai/apps/${result.id}
+
+4. **Publish**:
+   When ready, use publish_app to make it public:
+   \`publish_app(app_id: "${result.id}")\`
+
+## Example Code Structure
+
+\`\`\`jsx
+function MyApp() {
+  const [result, setResult] = React.useState(null);
+  const [loading, setLoading] = React.useState(false);
+  const [error, setError] = React.useState(null);
+
+  const handleSubmit = async (input) => {
+    setLoading(true);
+    setError(null);
+    try {
+      const output = await invokeWorkflow('YOUR_WORKFLOW_HASH', { input });
+      setResult(output);
+    } catch (err) {
+      setError(err.message || 'Something went wrong');
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="min-h-screen bg-gray-50 p-6">
+      <h1 className="text-2xl font-bold mb-4">${result.name}</h1>
+      {error && <div className="text-red-600 mb-4">{error}</div>}
+      {/* Your UI here using Tailwind classes */}
+    </div>
+  );
+}
+\`\`\`
+
+Use get_app_template for more complete examples.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error creating app: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=create-app.js.map

package/dist/tools/create-app.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * create_custom_node MCP Tool
+ *
+ * Create a new custom node with script code.
+ * Scope: custom_nodes:manage
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+import { CustomNodeSocket, CustomNodeProperty } from '../types.js';
+export declare const createCustomNodeTool: Tool;
+export declare function handleCreateCustomNode(api: FlowDotApiClient, args: {
+    name: string;
+    title: string;
+    description: string;
+    category?: string;
+    version?: string;
+    icon?: string;
+    inputs: CustomNodeSocket[];
+    outputs: CustomNodeSocket[];
+    properties?: CustomNodeProperty[];
+    script_code: string;
+    execution_timeout?: number;
+    memory_limit?: number;
+    visibility?: 'private' | 'public' | 'unlisted';
+    tags?: string[];
+    llm_enabled?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=create-custom-node.d.ts.map

package/dist/tools/create-custom-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-custom-node.d.ts","sourceRoot":"","sources":["../../src/tools/create-custom-node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGnE,eAAO,MAAM,oBAAoB,EAAE,IAqKlC,CAAC;AAEF,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,cAAc,CAAC,CAiDzB"}