@flowdot.ai/mcp-server 1.0.0 → 1.0.1

package/dist/tools/query-knowledge-base.js

@@ -0,0 +1,144 @@
+/**
+ * Query Knowledge Base Tool
+ *
+ * Performs RAG queries against the knowledge base to retrieve relevant document chunks.
+ * Supports filtering by team and controlling which document sources to include.
+ */
+export const queryKnowledgeBaseToolDef = {
+    name: 'query_knowledge_base',
+    description: 'Search your knowledge base using semantic and keyword search. Returns relevant document chunks with source attribution. Use this to find information from your uploaded documents. By default searches both personal and team documents.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'The search query - what information are you looking for?',
+            },
+            category_id: {
+                type: 'number',
+                description: 'Optional: Limit search to a specific category by ID',
+            },
+            team_id: {
+                type: 'number',
+                description: 'Optional: Limit search to a specific team\'s documents only. Use list_user_teams to see available teams.',
+            },
+            include_personal: {
+                type: 'boolean',
+                description: 'Optional: Include personal documents in the search. Default: true',
+            },
+            include_team: {
+                type: 'boolean',
+                description: 'Optional: Include team documents in the search. Default: true',
+            },
+            top_k: {
+                type: 'number',
+                description: 'Number of results to return (1-50, default: 5)',
+                minimum: 1,
+                maximum: 50,
+            },
+        },
+        required: ['query'],
+    },
+};
+export async function handleQueryKnowledgeBase(api, args) {
+    try {
+        const response = await api.queryKnowledgeBase({
+            query: args.query,
+            category_id: args.category_id,
+            team_id: args.team_id,
+            include_personal: args.include_personal,
+            include_team: args.include_team,
+            top_k: args.top_k || 5,
+        });
+        if (response.result_count === 0) {
+            let tips = [
+                'Using different keywords',
+                'Checking if documents are fully processed (status: ready)',
+                'Removing category filters',
+            ];
+            if (args.include_personal === false || args.include_team === false) {
+                tips.push('Including both personal and team documents');
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No results found for query: "${args.query}"\n\nTry:\n${tips.map(t => `- ${t}`).join('\n')}`,
+                    },
+                ],
+            };
+        }
+        const lines = [
+            `## Knowledge Base Results (${response.result_count} matches)`,
+            '',
+            `**Query:** "${args.query}"`,
+        ];
+        // Add filter info if any filters applied
+        const filters = [];
+        if (args.team_id)
+            filters.push(`Team ID: ${args.team_id}`);
+        if (args.category_id)
+            filters.push(`Category ID: ${args.category_id}`);
+        if (args.include_personal === false)
+            filters.push('Personal: excluded');
+        if (args.include_team === false)
+            filters.push('Team: excluded');
+        if (filters.length > 0) {
+            lines.push(`**Filters:** ${filters.join(', ')}`);
+        }
+        lines.push('');
+        // Track unique sources for citation
+        const sources = new Map();
+        for (let i = 0; i < response.results.length; i++) {
+            const result = response.results[i];
+            // Track source
+            sources.set(result.document_hash || result.document_title, {
+                title: result.document_title,
+                isTeam: result.is_team_document,
+                teamId: result.team_id ?? undefined,
+            });
+            // Calculate relevance indicator
+            let relevanceStr = '';
+            if (result.similarity !== null) {
+                const similarity = (result.similarity * 100).toFixed(0);
+                relevanceStr = ` (${similarity}% match)`;
+            }
+            else if (result.relevance !== null) {
+                relevanceStr = ` (relevance: ${result.relevance.toFixed(2)})`;
+            }
+            // Add team indicator if from team
+            const sourceLabel = result.is_team_document
+                ? `"${result.document_title}" [Team]`
+                : `"${result.document_title}"`;
+            lines.push(`### Result ${i + 1} from ${sourceLabel}${relevanceStr}`);
+            lines.push('');
+            // Show the content (truncate if very long)
+            const content = result.content.length > 2000
+                ? result.content.substring(0, 2000) + '... (truncated)'
+                : result.content;
+            lines.push(content);
+            lines.push('');
+        }
+        // Add sources footer
+        lines.push('---');
+        const personalSources = Array.from(sources.values()).filter(s => !s.isTeam);
+        const teamSources = Array.from(sources.values()).filter(s => s.isTeam);
+        if (personalSources.length > 0) {
+            lines.push(`**Personal Sources:** ${personalSources.map(s => s.title).join(', ')}`);
+        }
+        if (teamSources.length > 0) {
+            lines.push(`**Team Sources:** ${teamSources.map(s => s.title).join(', ')}`);
+        }
+        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 querying knowledge base: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=query-knowledge-base.js.map

package/dist/tools/query-knowledge-base.js.map

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

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

@@ -0,0 +1,11 @@
+/**
+ * rename_app_file Tool
+ *
+ * Rename or move a file in 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 renameAppFileTool: Tool;
+export declare function handleRenameAppFile(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=rename-app-file.d.ts.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * rename_app_file Tool
+ *
+ * Rename or move a file in a multi-file FlowDot app.
+ * Required scope: apps:manage
+ */
+export const renameAppFileTool = {
+    name: 'rename_app_file',
+    description: `Rename or move a file within a multi-file FlowDot app.
+
+Changes the file's path while preserving its content. Can be used to:
+- Rename a file (e.g., "Button.jsx" -> "PrimaryButton.jsx")
+- Move to a different directory (e.g., "Button.jsx" -> "components/Button.jsx")
+- Both rename and move at once
+
+File constraints:
+- Allowed extensions: jsx, js, tsx, ts, css, json, md
+- No path traversal (../) allowed
+- No hidden files (starting with .)`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            file_path: {
+                type: 'string',
+                description: 'The current file path',
+            },
+            new_path: {
+                type: 'string',
+                description: 'The new file path',
+            },
+        },
+        required: ['app_id', 'file_path', 'new_path'],
+    },
+};
+export async function handleRenameAppFile(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const filePath = String(args.file_path);
+        const newPath = String(args.new_path);
+        const result = await client.renameAppFile(appId, filePath, { new_path: newPath });
+        const text = `# File Renamed Successfully
+
+**Old Path:** ${filePath}
+**New Path:** ${result.path}
+**App:** ${appId}
+
+The file has been renamed/moved successfully.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error renaming app file: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=rename-app-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rename-app-file.js","sourceRoot":"","sources":["../../src/tools/rename-app-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;oCAUqB;IAClC,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,uBAAuB;aACrC;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC;KAC9C;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;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QAElF,MAAM,IAAI,GAAG;;gBAED,QAAQ;gBACR,MAAM,CAAC,IAAI;WAChB,KAAK;;8CAE8B,CAAC;QAE3C,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/reprocess-document.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Reprocess Document Tool
+ *
+ * Reprocesses a failed or pending document.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const reprocessDocumentToolDef: Tool;
+export declare function handleReprocessDocument(api: FlowDotApiClient, args: {
+    document_id: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=reprocess-document.d.ts.map

package/dist/tools/reprocess-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reprocess-document.d.ts","sourceRoot":"","sources":["../../src/tools/reprocess-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,wBAAwB,EAAE,IActC,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmBzB"}

package/dist/tools/reprocess-document.js

@@ -0,0 +1,40 @@
+/**
+ * Reprocess Document Tool
+ *
+ * Reprocesses a failed or pending document.
+ */
+export const reprocessDocumentToolDef = {
+    name: 'reprocess_document',
+    description: 'Reprocess a document that failed processing or is stuck in pending/processing status. Clears existing chunks and requeues for processing.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            document_id: {
+                type: 'number',
+                description: 'The ID of the document to reprocess',
+            },
+        },
+        required: ['document_id'],
+    },
+};
+export async function handleReprocessDocument(api, args) {
+    try {
+        await api.reprocessDocument(args.document_id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Document ${args.document_id} queued for reprocessing.\n\nUse list_knowledge_documents or get_knowledge_document to check the status.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error reprocessing document: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=reprocess-document.js.map

package/dist/tools/reprocess-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reprocess-document.js","sourceRoot":"","sources":["../../src/tools/reprocess-document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,wBAAwB,GAAS;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,2IAA2I;IAC7I,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAqB,EACrB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE9C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,YAAY,IAAI,CAAC,WAAW,0GAA0G;iBAC7I;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,gCAAgC,OAAO,EAAE,EAAE,CAAC;YAC5E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/search-apps.js

@@ -6,10 +6,10 @@
  */
 export const searchAppsTool = {
     name: 'search_apps',
-    description: `Search the FlowDot app marketplace for public apps created by other users.
-
-Apps are React frontend applications that can optionally use workflows as backends. You can search by keywords, filter by category/tag, and sort results.
-
+    description: `Search the FlowDot app marketplace for public apps created by other users.
+
+Apps are React frontend applications that can optionally use workflows as backends. You can search by keywords, filter by category/tag, and sort results.
+
 Use this to discover reusable apps that can be cloned and customized.`,
     inputSchema: {
         type: 'object',
@@ -77,17 +77,17 @@ export async function handleSearchApps(client, args) {
             if (app.is_featured)
                 badges.push('Featured');
             const badgeStr = badges.length ? ` (${badges.join(', ')})` : '';
-            return `- **${app.name}** (${app.id})${badgeStr}
-  By: ${app.user_name || 'Unknown'}
-  ${app.description || 'No description'}
-  Category: ${app.category || 'Uncategorized'} | Mobile: ${app.mobile_compatible ? 'Yes' : 'No'}
-  Upvotes: ${app.upvotes} | Executions: ${app.execution_count} | Clones: ${app.clone_count}
+            return `- **${app.name}** (${app.id})${badgeStr}
+  By: ${app.user_name || 'Unknown'}
+  ${app.description || 'No description'}
+  Category: ${app.category || 'Uncategorized'} | Mobile: ${app.mobile_compatible ? 'Yes' : 'No'}
+  Upvotes: ${app.upvotes} | Executions: ${app.execution_count} | Clones: ${app.clone_count}
   ${tags ? `Tags: ${tags}` : ''}`;
         });
-        const text = `Found ${result.total} public app(s) (page ${result.current_page}/${result.last_page}):
-
-${appsInfo.join('\n\n')}
-
+        const text = `Found ${result.total} public app(s) (page ${result.current_page}/${result.last_page}):
+
+${appsInfo.join('\n\n')}
+
 Tip: Use get_app to see full details and code, or clone_app to copy to your library.`;
         return {
             content: [{ type: 'text', text }],

package/dist/tools/search.d.ts

@@ -0,0 +1,14 @@
+/**
+ * search MCP Tool
+ *
+ * A general-purpose search tool for FlowDot resources.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const searchTool: Tool;
+export declare function handleSearch(api: FlowDotApiClient, args: {
+    query: string;
+    type?: 'workflow' | 'app' | 'custom_node';
+    page?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAQpD,eAAO,MAAM,UAAU,EAAE,IAuBxB,CAAC;AAEF,wBAAsB,YAAY,CAChC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,cAAc,CAAC,CA+DzB"}

package/dist/tools/search.js

@@ -0,0 +1,86 @@
+/**
+ * search MCP Tool
+ *
+ * A general-purpose search tool for FlowDot resources.
+ */
+export const searchTool = {
+    name: 'search',
+    description: 'Search for resources like workflows, apps, and custom nodes within the FlowDot platform.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Search query to match against resource name, description, or tags.',
+            },
+            type: {
+                type: 'string',
+                description: "Optional: The type of resource to search for. Can be 'workflow', 'app', or 'custom_node'. If omitted, all types are searched.",
+                enum: ['workflow', 'app', 'custom_node'],
+            },
+            page: {
+                type: 'number',
+                description: 'Page number for pagination.',
+                default: 1,
+            },
+        },
+        required: ['query'],
+    },
+};
+export async function handleSearch(api, args) {
+    const { query, type, page = 1 } = args;
+    try {
+        const searchPromises = [];
+        const typesToSearch = [];
+        if (!type || type === 'workflow') {
+            searchPromises.push(api.searchWorkflows(query, undefined, page));
+            typesToSearch.push('workflow');
+        }
+        if (!type || type === 'app') {
+            searchPromises.push(api.searchPublicApps({ q: query, page }));
+            typesToSearch.push('app');
+        }
+        if (!type || type === 'custom_node') {
+            searchPromises.push(api.searchPublicCustomNodes({ q: query, page }));
+            typesToSearch.push('custom_node');
+        }
+        const results = await Promise.allSettled(searchPromises);
+        let lines = [];
+        let totalResults = 0;
+        results.forEach((result, index) => {
+            if (result.status === 'fulfilled') {
+                const paginatedResult = result.value;
+                const items = Array.isArray(paginatedResult?.data) ? paginatedResult.data : [];
+                if (items.length > 0) {
+                    const resourceType = typesToSearch[index];
+                    lines.push(`### ${resourceType.charAt(0).toUpperCase() + resourceType.slice(1)}s`);
+                    items.forEach(item => {
+                        const visibility = ('is_public' in item && item.is_public) ? ' (public)' : '';
+                        const desc = item.description ? ` - ${item.description}` : '';
+                        lines.push(`- **${item.name}** (${item.id})${visibility}${desc}`);
+                    });
+                    lines.push('');
+                    totalResults += items.length;
+                }
+            }
+        });
+        if (totalResults === 0) {
+            return {
+                content: [{ type: 'text', text: `No results found for "${query}".` }],
+            };
+        }
+        const header = `## Search Results for "${query}" (Page ${page})`;
+        lines.unshift(header, '');
+        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 during search: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/set-app-entry-file.d.ts

@@ -0,0 +1,11 @@
+/**
+ * set_app_entry_file Tool
+ *
+ * Set a file as the entry point for 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 setAppEntryFileTool: Tool;
+export declare function handleSetAppEntryFile(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=set-app-entry-file.d.ts.map

package/dist/tools/set-app-entry-file.d.ts.map

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

package/dist/tools/set-app-entry-file.js

@@ -0,0 +1,56 @@
+/**
+ * set_app_entry_file Tool
+ *
+ * Set a file as the entry point for a multi-file FlowDot app.
+ * Required scope: apps:manage
+ */
+export const setAppEntryFileTool = {
+    name: 'set_app_entry_file',
+    description: `Set a file as the entry point for a multi-file FlowDot app.
+
+The entry point is the main file that gets rendered when the app loads. Only one file can be the entry point at a time.
+
+When you set a new entry point:
+- The specified file becomes the entry point
+- Any previous entry point is automatically unset
+
+Use list_app_files to see which file is currently the entry point.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            file_path: {
+                type: 'string',
+                description: 'The file path to set as entry point (e.g., "App.jsx")',
+            },
+        },
+        required: ['app_id', 'file_path'],
+    },
+};
+export async function handleSetAppEntryFile(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const filePath = String(args.file_path);
+        const result = await client.setAppEntryFile(appId, filePath);
+        const text = `# Entry Point Set Successfully
+
+**File:** ${result.path}
+**App:** ${appId}
+
+This file is now the entry point for the app. When the app loads, this file's main component will be rendered.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error setting entry point: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=set-app-entry-file.js.map

package/dist/tools/set-app-entry-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set-app-entry-file.js","sourceRoot":"","sources":["../../src/tools/set-app-entry-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,mBAAmB,GAAS;IACvC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE;;;;;;;;mEAQoD;IACjE,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,uDAAuD;aACrE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;KAClC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,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,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAE7D,MAAM,IAAI,GAAG;;YAEL,MAAM,CAAC,IAAI;WACZ,KAAK;;+GAE+F,CAAC;QAE5G,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,8BAA8B,OAAO,EAAE,EAAE,CAAC;YAC1E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/transfer-document-ownership.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Transfer Document Ownership Tool
+ *
+ * Transfers a document between personal and team knowledge bases.
+ * Can also optionally change the category during transfer.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const transferDocumentOwnershipToolDef: Tool;
+export declare function handleTransferDocumentOwnership(api: FlowDotApiClient, args: {
+    document_id: number;
+    team_id?: number | null;
+    category_id?: number | null;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=transfer-document-ownership.d.ts.map

package/dist/tools/transfer-document-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-document-ownership.d.ts","sourceRoot":"","sources":["../../src/tools/transfer-document-ownership.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,gCAAgC,EAAE,IAwB9C,CAAC;AAEF,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,GACA,OAAO,CAAC,cAAc,CAAC,CAqCzB"}

package/dist/tools/transfer-document-ownership.js

@@ -0,0 +1,66 @@
+/**
+ * Transfer Document Ownership Tool
+ *
+ * Transfers a document between personal and team knowledge bases.
+ * Can also optionally change the category during transfer.
+ */
+export const transferDocumentOwnershipToolDef = {
+    name: 'transfer_document_ownership',
+    description: 'Transfer a document between your personal knowledge base and a team knowledge base. You can also optionally assign a category in the target scope during transfer.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            document_id: {
+                type: 'number',
+                description: 'The document ID to transfer',
+            },
+            team_id: {
+                type: ['number', 'null'],
+                description: 'Target team ID to transfer to, or null/omit to transfer to personal. Use list_user_teams to see available teams.',
+            },
+            category_id: {
+                type: ['number', 'null'],
+                description: 'Optional category ID in the target scope. Must belong to the target team (or personal if transferring to personal). Set to null to remove category.',
+            },
+        },
+        required: ['document_id'],
+    },
+};
+export async function handleTransferDocumentOwnership(api, args) {
+    try {
+        const result = await api.transferDocumentOwnership(args.document_id, {
+            team_id: args.team_id,
+            category_id: args.category_id,
+        });
+        const lines = ['## Document Transferred Successfully', ''];
+        lines.push(result.message);
+        lines.push('');
+        lines.push('### Document Details');
+        lines.push(`- **ID:** ${result.document.id}`);
+        lines.push(`- **Hash:** ${result.document.hash}`);
+        lines.push(`- **Title:** ${result.document.title}`);
+        if (result.document.team_id) {
+            lines.push(`- **Team:** ${result.document.team_name} (ID: ${result.document.team_id})`);
+        }
+        else {
+            lines.push(`- **Location:** Personal knowledge base`);
+        }
+        if (result.document.category_id) {
+            lines.push(`- **Category ID:** ${result.document.category_id}`);
+        }
+        else {
+            lines.push(`- **Category:** Uncategorized`);
+        }
+        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 transferring document: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=transfer-document-ownership.js.map

package/dist/tools/transfer-document-ownership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer-document-ownership.js","sourceRoot":"","sources":["../../src/tools/transfer-document-ownership.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,gCAAgC,GAAS;IACpD,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,oKAAoK;IACtK,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACxB,WAAW,EACT,kHAAkH;aACrH;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACxB,WAAW,EACT,qJAAqJ;aACxJ;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,GAAqB,EACrB,IAIC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,yBAAyB,CAAC,IAAI,CAAC,WAAW,EAAE;YACnE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAEpD,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,SAAS,SAAS,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,CAAC;QAED,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,gCAAgC,OAAO,EAAE,EAAE,CAAC;YAC5E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/unlink-app-workflow.js

@@ -6,8 +6,8 @@
  */
 export const unlinkAppWorkflowTool = {
     name: 'unlink_app_workflow',
-    description: `Unlink a workflow from an app. After unlinking, the app will no longer be able to invoke that workflow.
-
+    description: `Unlink a workflow from an app. After unlinking, the app will no longer be able to invoke that workflow.
+
 Make sure to update your app code to remove any references to the unlinked workflow.`,
     inputSchema: {
         type: 'object',