@flowdot.ai/mcp-server 1.0.0 → 1.0.1

package/dist/tools/create-knowledge-category.js

@@ -0,0 +1,71 @@
+/**
+ * Create Knowledge Category Tool
+ *
+ * Creates a new document category in the knowledge base.
+ * Can create personal categories or team categories.
+ */
+export const createKnowledgeCategoryToolDef = {
+    name: 'create_knowledge_category',
+    description: 'Create a new category to organize documents in your knowledge base. Categories help group related documents for targeted RAG queries. Can create personal or team categories.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name for the category (max 100 characters)',
+            },
+            description: {
+                type: 'string',
+                description: 'Optional description of what documents belong in this category (max 500 characters)',
+            },
+            color: {
+                type: 'string',
+                description: 'Optional hex color code for the category (e.g., #3B82F6). Default: blue',
+                pattern: '^#[0-9A-Fa-f]{6}$',
+            },
+            team_id: {
+                type: 'number',
+                description: 'Optional: Team ID to create the category for. If omitted, creates a personal category. Use list_user_teams to see available teams.',
+            },
+        },
+        required: ['name'],
+    },
+};
+export async function handleCreateKnowledgeCategory(api, args) {
+    try {
+        const category = await api.createKnowledgeCategory({
+            name: args.name,
+            description: args.description,
+            color: args.color,
+            team_id: args.team_id,
+        });
+        const lines = [
+            `## Category Created Successfully`,
+            '',
+            `**Name:** ${category.name}`,
+            `**ID:** ${category.id}`,
+            `**Slug:** ${category.slug}`,
+            category.description ? `**Description:** ${category.description}` : '',
+            `**Color:** ${category.color}`,
+        ].filter(Boolean);
+        if (category.team_id) {
+            lines.push(`**Team:** ${category.team_name || 'Unknown'} (ID: ${category.team_id})`);
+        }
+        else {
+            lines.push(`**Location:** Personal knowledge base`);
+        }
+        lines.push('');
+        lines.push(`You can now upload documents to this category using the category_id: ${category.id}`);
+        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 creating category: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=create-knowledge-category.js.map

package/dist/tools/create-knowledge-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-knowledge-category.js","sourceRoot":"","sources":["../../src/tools/create-knowledge-category.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,8BAA8B,GAAS;IAClD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,+KAA+K;IACjL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qFAAqF;aACnG;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;gBACtF,OAAO,EAAE,mBAAmB;aAC7B;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oIAAoI;aAClJ;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAqB,EACrB,IAA8E;IAE9E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,kCAAkC;YAClC,EAAE;YACF,aAAa,QAAQ,CAAC,IAAI,EAAE;YAC5B,WAAW,QAAQ,CAAC,EAAE,EAAE;YACxB,aAAa,QAAQ,CAAC,IAAI,EAAE;YAC5B,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;YACtE,cAAc,QAAQ,CAAC,KAAK,EAAE;SAC/B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,SAAS,IAAI,SAAS,SAAS,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACtD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wEAAwE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAElG,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,4BAA4B,OAAO,EAAE,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

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

package/dist/tools/delete-app-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-app-file.d.ts","sourceRoot":"","sources":["../../src/tools/delete-app-file.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,iBAAiB,EAAE,IAqB/B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAwBzB"}

package/dist/tools/delete-app-file.js

@@ -0,0 +1,52 @@
+/**
+ * delete_app_file Tool
+ *
+ * Delete a file from a multi-file FlowDot app.
+ * Required scope: apps:manage
+ */
+export const deleteAppFileTool = {
+    name: 'delete_app_file',
+    description: `Delete a file from a multi-file FlowDot app.
+
+Permanently removes the file from the app. This action cannot be undone.
+
+Note: Deleting the entry point file will require you to set a new entry point using set_app_entry_file.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            file_path: {
+                type: 'string',
+                description: 'The file path to delete (e.g., "OldComponent.jsx")',
+            },
+        },
+        required: ['app_id', 'file_path'],
+    },
+};
+export async function handleDeleteAppFile(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const filePath = String(args.file_path);
+        await client.deleteAppFile(appId, filePath);
+        const text = `# File Deleted Successfully
+
+**Path:** ${filePath}
+**App:** ${appId}
+
+The file has been permanently removed from the app.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error deleting app file: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=delete-app-file.js.map

package/dist/tools/delete-app-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-app-file.js","sourceRoot":"","sources":["../../src/tools/delete-app-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;wGAIyF;IACtG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oDAAoD;aAClE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAClC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAExC,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAE5C,MAAM,IAAI,GAAG;;YAEL,QAAQ;WACT,KAAK;;oDAEoC,CAAC;QAEjD,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,4BAA4B,OAAO,EAAE,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/delete-app.js

@@ -6,9 +6,9 @@
  */
 export const deleteAppTool = {
     name: 'delete_app',
-    description: `Permanently delete an app. This action cannot be undone.
-
-The app and all its associated data (comments, votes, etc.) will be removed.
+    description: `Permanently delete an app. This action cannot be undone.
+
+The app and all its associated data (comments, votes, etc.) will be removed.
 Existing clones of the app will continue to work for their owners.`,
     inputSchema: {
         type: 'object',

package/dist/tools/delete-knowledge-category.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Delete Knowledge Category Tool
+ *
+ * Deletes a document category. Documents in the category become uncategorized.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const deleteKnowledgeCategoryToolDef: Tool;
+export declare function handleDeleteKnowledgeCategory(api: FlowDotApiClient, args: {
+    category_id: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=delete-knowledge-category.d.ts.map

package/dist/tools/delete-knowledge-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-knowledge-category.d.ts","sourceRoot":"","sources":["../../src/tools/delete-knowledge-category.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,8BAA8B,EAAE,IAc5C,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmBzB"}

package/dist/tools/delete-knowledge-category.js

@@ -0,0 +1,40 @@
+/**
+ * Delete Knowledge Category Tool
+ *
+ * Deletes a document category. Documents in the category become uncategorized.
+ */
+export const deleteKnowledgeCategoryToolDef = {
+    name: 'delete_knowledge_category',
+    description: 'Delete a knowledge base category. Documents in the category will become uncategorized (not deleted).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category_id: {
+                type: 'number',
+                description: 'The ID of the category to delete',
+            },
+        },
+        required: ['category_id'],
+    },
+};
+export async function handleDeleteKnowledgeCategory(api, args) {
+    try {
+        const result = await api.deleteKnowledgeCategory(args.category_id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.message || `Category ${args.category_id} deleted successfully.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error deleting category: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=delete-knowledge-category.js.map

package/dist/tools/delete-knowledge-category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-knowledge-category.js","sourceRoot":"","sources":["../../src/tools/delete-knowledge-category.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,8BAA8B,GAAS;IAClD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,sGAAsG;IACxG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAqB,EACrB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,YAAY,IAAI,CAAC,WAAW,wBAAwB;iBAC7E;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,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,OAAO,EAAE,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/delete-knowledge-document.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Delete Knowledge Document Tool
+ *
+ * Deletes a document from the knowledge base.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const deleteKnowledgeDocumentToolDef: Tool;
+export declare function handleDeleteKnowledgeDocument(api: FlowDotApiClient, args: {
+    document_id: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=delete-knowledge-document.d.ts.map

package/dist/tools/delete-knowledge-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-knowledge-document.d.ts","sourceRoot":"","sources":["../../src/tools/delete-knowledge-document.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,8BAA8B,EAAE,IAc5C,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmBzB"}

package/dist/tools/delete-knowledge-document.js

@@ -0,0 +1,40 @@
+/**
+ * Delete Knowledge Document Tool
+ *
+ * Deletes a document from the knowledge base.
+ */
+export const deleteKnowledgeDocumentToolDef = {
+    name: 'delete_knowledge_document',
+    description: 'Permanently delete a document from your knowledge base. This removes the file and all associated chunks/embeddings.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            document_id: {
+                type: 'number',
+                description: 'The ID of the document to delete',
+            },
+        },
+        required: ['document_id'],
+    },
+};
+export async function handleDeleteKnowledgeDocument(api, args) {
+    try {
+        const result = await api.deleteKnowledgeDocument(args.document_id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.message || `Document ${args.document_id} deleted successfully.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error deleting document: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=delete-knowledge-document.js.map

package/dist/tools/delete-knowledge-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-knowledge-document.js","sourceRoot":"","sources":["../../src/tools/delete-knowledge-document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,8BAA8B,GAAS;IAClD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,qHAAqH;IACvH,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAqB,EACrB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEnE,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,YAAY,IAAI,CAAC,WAAW,wBAAwB;iBAC7E;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,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,OAAO,EAAE,EAAE,CAAC;YACxE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * 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';
+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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-app-code.d.ts","sourceRoot":"","sources":["../../src/tools/edit-app-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,eAAe,EAAE,IAyD7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CA+CzB"}

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

@@ -0,0 +1,110 @@
+/**
+ * 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>;"`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash) to edit',
+            },
+            old_string: {
+                type: 'string',
+                description: 'The exact string to find and replace (must exist in code)',
+            },
+            new_string: {
+                type: 'string',
+                description: 'The replacement string',
+            },
+            field: {
+                type: 'string',
+                enum: ['code', 'mobile_code'],
+                description: 'Which code field to edit (default: "code")',
+            },
+            replace_all: {
+                type: 'boolean',
+                description: 'If true, replace all occurrences. If false (default), fails when multiple matches found.',
+            },
+        },
+        required: ['app_id', 'old_string', 'new_string'],
+    },
+};
+export async function handleEditAppCode(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const oldString = String(args.old_string);
+        const newString = String(args.new_string);
+        const field = args.field || 'code';
+        const replaceAll = Boolean(args.replace_all);
+        const result = await client.editAppCode(appId, {
+            old_string: oldString,
+            new_string: newString,
+            field,
+            replace_all: replaceAll,
+        });
+        const sizeDiff = result.new_length - result.previous_length;
+        const sizeChange = sizeDiff >= 0 ? `+${sizeDiff}` : String(sizeDiff);
+        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)
+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' +
+                '- Ensure old_string matches EXACTLY (including whitespace and line endings)\n' +
+                '- Check for CRLF vs LF newline differences\n' +
+                '- Use get_app to view the current code and copy the exact string';
+        }
+        return {
+            content: [{ type: 'text', text: `Error editing app code: ${message}${debugInfo}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=edit-app-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit-app-code.js","sourceRoot":"","sources":["../../src/tools/edit-app-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;0EA2B2D;IACxE,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2BAA2B;aACzC;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;gBAC7B,WAAW,EAAE,4CAA4C;aAC1D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,0FAA0F;aACxG;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC;KACjD;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgC,IAAI,MAAM,CAAC;QAC/D,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE;YAC7C,UAAU,EAAE,SAAS;YACrB,UAAU,EAAE,SAAS;YACrB,KAAK;YACL,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAC5D,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAErE,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;UAEJ,MAAM,CAAC,EAAE;SACV,MAAM,CAAC,KAAK;iBACJ,MAAM,CAAC,eAAe;YAC3B,MAAM,CAAC,UAAU,WAAW,UAAU;cACpC,MAAM,CAAC,UAAU,EAAE;iBAC1B,CAAC;SACH,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;QAEzE,kFAAkF;QAClF,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,SAAS,GAAG,6BAA6B;gBACvC,+EAA+E;gBAC/E,8CAA8C;gBAC9C,kEAAkE,CAAC;QACvE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,OAAO,GAAG,SAAS,EAAE,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * 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';
+export declare const getAppFileTool: Tool;
+export declare function handleGetAppFile(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=get-app-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-app-file.d.ts","sourceRoot":"","sources":["../../src/tools/get-app-file.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,cAAc,EAAE,IAyB5B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CA8CzB"}

package/dist/tools/get-app-file.js

@@ -0,0 +1,76 @@
+/**
+ * get_app_file Tool
+ *
+ * Get a specific file from a multi-file FlowDot app.
+ * Required scope: apps:read
+ */
+export const getAppFileTool = {
+    name: 'get_app_file',
+    description: `Get the content and details of a specific file in a multi-file FlowDot app.
+
+Returns the file's:
+- Path
+- Content (full source code)
+- Type (component, hook, utility, page, context, style)
+- Entry point status
+
+Use list_app_files first to see available files in the app.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            file_path: {
+                type: 'string',
+                description: 'The file path within the app (e.g., "App.jsx", "components/Button.jsx")',
+            },
+        },
+        required: ['app_id', 'file_path'],
+    },
+};
+export async function handleGetAppFile(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const filePath = String(args.file_path);
+        const file = await client.getAppFile(appId, filePath);
+        // Determine file language for syntax highlighting
+        const ext = filePath.split('.').pop()?.toLowerCase() || 'text';
+        const langMap = {
+            jsx: 'jsx',
+            tsx: 'tsx',
+            js: 'javascript',
+            ts: 'typescript',
+            css: 'css',
+            json: 'json',
+            md: 'markdown',
+        };
+        const lang = langMap[ext] || 'text';
+        const entryBadge = file.is_entry ? ' [ENTRY POINT]' : '';
+        const text = `# ${filePath}${entryBadge}
+
+**Type:** ${file.type}
+**Entry Point:** ${file.is_entry ? 'Yes' : 'No'}
+**Created:** ${file.created_at || 'N/A'}
+**Updated:** ${file.updated_at || 'N/A'}
+
+## Content
+
+\`\`\`${lang}
+${file.content}
+\`\`\`
+`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error getting app file: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-app-file.js.map

package/dist/tools/get-app-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-app-file.js","sourceRoot":"","sources":["../../src/tools/get-app-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE;;;;;;;;4DAQ6C;IAC1D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yEAAyE;aACvF;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAClC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAExC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEtD,kDAAkD;QAClD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;QAC/D,MAAM,OAAO,GAA2B;YACtC,GAAG,EAAE,KAAK;YACV,GAAG,EAAE,KAAK;YACV,EAAE,EAAE,YAAY;YAChB,EAAE,EAAE,YAAY;YAChB,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,UAAU;SACf,CAAC;QACF,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;QAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;QAEzD,MAAM,IAAI,GAAG,KAAK,QAAQ,GAAG,UAAU;;YAE/B,IAAI,CAAC,IAAI;mBACF,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;eAChC,IAAI,CAAC,UAAU,IAAI,KAAK;eACxB,IAAI,CAAC,UAAU,IAAI,KAAK;;;;QAI/B,IAAI;EACV,IAAI,CAAC,OAAO;;CAEb,CAAC;QAEE,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,2BAA2B,OAAO,EAAE,EAAE,CAAC;YACvE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/get-app-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-app-template.d.ts","sourceRoot":"","sources":["../../src/tools/get-app-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,EAAE,IAgEhC,CAAC;AAuoBF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAkJzB"}
+{"version":3,"file":"get-app-template.d.ts","sourceRoot":"","sources":["../../src/tools/get-app-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAE1E,eAAO,MAAM,kBAAkB,EAAE,IAoFhC,CAAC;AA+pBF,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAkJzB"}