@flowdot.ai/mcp-server 1.0.0 → 1.0.2

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

@@ -0,0 +1,97 @@
+/**
+ * insert_app_code Tool
+ *
+ * Inserts content after a specific pattern in app code.
+ * Use this to add code at specific locations without replacing existing code.
+ * Required scope: apps:manage
+ */
+export const insertAppCodeTool = {
+    name: 'insert_app_code',
+    description: `Inserts content after a specific pattern in app code.
+
+CRITICAL: Remember export rules:
+- App entry file MUST end with: export default MyAppName;
+- To add helper functions, insert BEFORE the export statement
+- Use after_pattern to find the closing brace of your main component
+
+Use this tool when you need to:
+- Add new state declarations after existing ones
+- Insert event handlers inside a component
+- Add JSX elements at specific locations
+- Insert code without replacing what's already there
+
+IMPORTANT:
+- after_pattern must exist EXACTLY in the code (including whitespace)
+- Content is inserted immediately after the pattern (first occurrence)
+- For multiple insertions at different locations, call this tool multiple times
+
+WORKFLOW FOR BUILDING LARGE APPS:
+1. Create app with skeleton: create_app + update_app with basic structure including export
+2. Use insert_app_code to add state: after_pattern: "function MyApp() {"
+   content: "\\n  const [data, setData] = React.useState(null);"
+3. To add helper functions: after_pattern: "}\\n\\n" (before export)
+   content: "function helperFunc() { ... }\\n\\n"
+
+Example:
+- after_pattern: "const [loading, setLoading] = React.useState(false);"
+- content: "\\n  const [error, setError] = React.useState(null);"
+
+Max code size: 102KB`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            after_pattern: {
+                type: 'string',
+                description: 'The pattern to find (content will be inserted after this)',
+            },
+            content: {
+                type: 'string',
+                description: 'The content to insert after the pattern',
+            },
+            field: {
+                type: 'string',
+                enum: ['code', 'mobile_code'],
+                description: 'Which code field to insert into (default: "code")',
+            },
+        },
+        required: ['app_id', 'after_pattern', 'content'],
+    },
+};
+export async function handleInsertAppCode(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const afterPattern = String(args.after_pattern);
+        const content = String(args.content);
+        const field = args.field || 'code';
+        const result = await client.insertAppCode(appId, {
+            after_pattern: afterPattern,
+            content,
+            field,
+        });
+        const sizeDiff = result.new_length - result.previous_length;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Content inserted into app code successfully!
+
+App ID: ${result.id}
+Field: ${result.field}
+Previous size: ${result.previous_length} bytes
+New size: ${result.new_length} bytes (+${sizeDiff} bytes)
+Updated at: ${result.updated_at}`,
+                }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error inserting into app code: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=insert-app-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"insert-app-code.js","sourceRoot":"","sources":["../../src/tools/insert-app-code.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA6BM;IACnB,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2DAA2D;aACzE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;gBAC7B,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC;KACjD;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,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,KAAK,GAAI,IAAI,CAAC,KAAgC,IAAI,MAAM,CAAC;QAE/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE;YAC/C,aAAa,EAAE,YAAY;YAC3B,OAAO;YACP,KAAK;SACN,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,CAAC;QAE5D,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,YAAY,QAAQ;cACnC,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;QACzE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kCAAkC,OAAO,EAAE,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -6,14 +6,14 @@
  */
 export const linkAppWorkflowTool = {
     name: 'link_app_workflow',
-    description: `Link a workflow to an app. Once linked, the app can invoke the workflow using invokeWorkflow().
-
-The workflow must be owned by you. After linking, use the workflow hash in your app code:
-
-\`\`\`javascript
-const result = await invokeWorkflow('WORKFLOW_HASH', { input: 'value' });
-\`\`\`
-
+    description: `Link a workflow to an app. Once linked, the app can invoke the workflow using invokeWorkflow().
+
+The workflow must be owned by you. After linking, use the workflow hash in your app code:
+
+\`\`\`javascript
+const result = await invokeWorkflow('WORKFLOW_HASH', { input: 'value' });
+\`\`\`
+
 You can optionally provide an alias to reference the workflow by a friendly name.`,
     inputSchema: {
         type: 'object',
@@ -40,19 +40,19 @@ export async function handleLinkAppWorkflow(client, args) {
         const workflowHash = String(args.workflow_hash);
         const alias = args.alias ? String(args.alias) : undefined;
         const result = await client.linkAppWorkflow(appId, workflowHash, alias);
-        const text = `Workflow linked successfully!
-
-**Workflow:** ${result.name} (${result.hash})
-${result.alias ? `**Alias:** ${result.alias}` : ''}
-${result.description ? `**Description:** ${result.description}` : ''}
-
-## Usage in App Code
-
-\`\`\`javascript
-// Invoke the workflow
-const result = await invokeWorkflow('${result.hash}', {
-  // your inputs here
-});
+        const text = `Workflow linked successfully!
+
+**Workflow:** ${result.name} (${result.hash})
+${result.alias ? `**Alias:** ${result.alias}` : ''}
+${result.description ? `**Description:** ${result.description}` : ''}
+
+## Usage in App Code
+
+\`\`\`javascript
+// Invoke the workflow
+const result = await invokeWorkflow('${result.hash}', {
+  // your inputs here
+});
 \`\`\``;
         return {
             content: [{ type: 'text', text }],

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

@@ -0,0 +1,14 @@
+/**
+ * link_recipe MCP Tool
+ *
+ * Links a recipe for use in MCP context.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const linkRecipeTool: Tool;
+export declare function handleLinkRecipe(api: FlowDotApiClient, args: {
+    hash: string;
+    alias: string;
+    is_default?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=link-recipe.d.ts.map

package/dist/tools/link-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-recipe.d.ts","sourceRoot":"","sources":["../../src/tools/link-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,eAAO,MAAM,cAAc,EAAE,IAkC5B,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

package/dist/tools/link-recipe.js

@@ -0,0 +1,76 @@
+/**
+ * link_recipe MCP Tool
+ *
+ * Links a recipe for use in MCP context.
+ */
+export const linkRecipeTool = {
+    name: 'link_recipe',
+    description: `Link a recipe for CLI execution. **REQUIRED** to run recipes from command line.
+
+**CRITICAL - Alias Rules:**
+- Use HYPHENS only: \`my-recipe\` ✓
+- NO underscores: \`my_recipe\` ✗ (causes 422 error)
+- Lowercase, alphanumeric + hyphens only
+
+**After Linking, Run via CLI:**
+\`\`\`bash
+npx flowdot recipes run <alias> --input '{"input_key":"value"}'
+\`\`\`
+
+**Note:** MCP tools can only DESIGN recipes. CLI is required to EXECUTE them.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            hash: {
+                type: 'string',
+                description: 'The recipe hash/ID to link',
+            },
+            alias: {
+                type: 'string',
+                description: 'A friendly alias for the recipe (e.g., "code-reviewer", "summarizer")',
+            },
+            is_default: {
+                type: 'boolean',
+                description: 'Whether this should be the default linked recipe',
+                default: false,
+            },
+        },
+        required: ['hash', 'alias'],
+    },
+};
+export async function handleLinkRecipe(api, args) {
+    try {
+        const input = {
+            alias: args.alias,
+            is_default: args.is_default,
+        };
+        const result = await api.linkRecipe(args.hash, input);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Recipe linked successfully!
+
+**Alias:** ${result.alias}
+**Recipe:** ${result.recipe_name} (${result.recipe_hash})
+**Default:** ${result.is_default ? 'Yes' : 'No'}
+
+You can now execute this recipe using the alias.`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error linking recipe: ${message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=link-recipe.js.map

package/dist/tools/link-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-recipe.js","sourceRoot":"","sources":["../../src/tools/link-recipe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;;;;;8EAY+D;IAC5E,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4BAA4B;aAC1C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uEAAuE;aACrF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kDAAkD;gBAC/D,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAqB,EACrB,IAA2D;IAE3D,IAAI,CAAC;QACH,MAAM,KAAK,GAAoB;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;;aAEH,MAAM,CAAC,KAAK;cACX,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW;eACxC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;;iDAEE;iBACxC;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,yBAAyB,OAAO,EAAE;iBACzC;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/list-app-files.d.ts

@@ -0,0 +1,11 @@
+/**
+ * list_app_files Tool
+ *
+ * List all files in 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 listAppFilesTool: Tool;
+export declare function handleListAppFiles(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=list-app-files.d.ts.map

package/dist/tools/list-app-files.d.ts.map

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

package/dist/tools/list-app-files.js

@@ -0,0 +1,84 @@
+/**
+ * list_app_files Tool
+ *
+ * List all files in a multi-file FlowDot app.
+ * Required scope: apps:read
+ */
+export const listAppFilesTool = {
+    name: 'list_app_files',
+    description: `List all files in a multi-file FlowDot app.
+
+Returns a list of files with their paths, types, and entry point status.
+
+Multi-file apps allow organizing React code across multiple files:
+- Component files (.jsx, .tsx)
+- Utility files (.js, .ts)
+- Style files (.css)
+- JSON configuration files
+
+Use get_app_file to retrieve the content of a specific file.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+        },
+        required: ['app_id'],
+    },
+};
+export async function handleListAppFiles(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const files = await client.listAppFiles(appId);
+        if (files.length === 0) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `No files found in app ${appId}.\n\nUse create_app_file to add files to this app.`,
+                    }],
+            };
+        }
+        // Group files by directory
+        const filesByDir = {};
+        for (const file of files) {
+            const dir = file.path.includes('/')
+                ? file.path.substring(0, file.path.lastIndexOf('/'))
+                : '(root)';
+            if (!filesByDir[dir]) {
+                filesByDir[dir] = [];
+            }
+            filesByDir[dir].push(file);
+        }
+        // Format output
+        let text = `# Files in App ${appId}\n\n`;
+        text += `**Total Files:** ${files.length}\n\n`;
+        // Find entry point
+        const entryFile = files.find(f => f.is_entry);
+        if (entryFile) {
+            text += `**Entry Point:** ${entryFile.path}\n\n`;
+        }
+        text += `## File List\n\n`;
+        for (const [dir, dirFiles] of Object.entries(filesByDir).sort()) {
+            text += `### ${dir}/\n\n`;
+            for (const file of dirFiles.sort((a, b) => a.path.localeCompare(b.path))) {
+                const entryBadge = file.is_entry ? ' [ENTRY]' : '';
+                const typeBadge = file.type ? ` (${file.type})` : '';
+                text += `- \`${file.path}\`${typeBadge}${entryBadge}\n`;
+            }
+            text += '\n';
+        }
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error listing app files: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-app-files.js.map

package/dist/tools/list-app-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-app-files.js","sourceRoot":"","sources":["../../src/tools/list-app-files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,gBAAgB,GAAS;IACpC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;;;;;;;;6DAU8C;IAC3D,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElC,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,yBAAyB,KAAK,oDAAoD;qBACzF,CAAC;aACH,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,MAAM,UAAU,GAAiC,EAAE,CAAC;QACpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;gBACpD,CAAC,CAAC,QAAQ,CAAC;YACb,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACvB,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,gBAAgB;QAChB,IAAI,IAAI,GAAG,kBAAkB,KAAK,MAAM,CAAC;QACzC,IAAI,IAAI,oBAAoB,KAAK,CAAC,MAAM,MAAM,CAAC;QAE/C,mBAAmB;QACnB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,IAAI,oBAAoB,SAAS,CAAC,IAAI,MAAM,CAAC;QACnD,CAAC;QAED,IAAI,IAAI,kBAAkB,CAAC;QAE3B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAChE,IAAI,IAAI,OAAO,GAAG,OAAO,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACzE,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,GAAG,UAAU,IAAI,CAAC;YAC1D,CAAC;YACD,IAAI,IAAI,IAAI,CAAC;QACf,CAAC;QAED,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/list-apps.js

@@ -6,8 +6,8 @@
  */
 export const listAppsTool = {
     name: 'list_apps',
-    description: `List the user's own FlowDot apps. Apps are React frontend applications that can optionally use workflows as backends.
-
+    description: `List the user's own FlowDot apps. Apps are React frontend applications that can optionally use workflows as backends.
+
 Returns a paginated list of apps owned by the current user with metadata like name, description, category, tags, and usage stats.`,
     inputSchema: {
         type: 'object',
@@ -51,14 +51,14 @@ export async function handleListApps(client, args) {
         const appsInfo = result.data.map((app) => {
             const tags = app.tags?.length ? `[${app.tags.join(', ')}]` : '';
             const status = app.is_public ? 'Public' : 'Private';
-            return `- **${app.name}** (${app.id})
-  ${app.description || 'No description'}
-  Category: ${app.category || 'Uncategorized'} | Status: ${status} | Mobile: ${app.mobile_compatible ? 'Yes' : 'No'}
-  Executions: ${app.execution_count} | Upvotes: ${app.upvotes} | Clones: ${app.clone_count}
+            return `- **${app.name}** (${app.id})
+  ${app.description || 'No description'}
+  Category: ${app.category || 'Uncategorized'} | Status: ${status} | Mobile: ${app.mobile_compatible ? 'Yes' : 'No'}
+  Executions: ${app.execution_count} | Upvotes: ${app.upvotes} | Clones: ${app.clone_count}
   ${tags ? `Tags: ${tags}` : ''}`;
         });
-        const text = `Found ${result.total} app(s) (page ${result.current_page}/${result.last_page}):
-
+        const text = `Found ${result.total} app(s) (page ${result.current_page}/${result.last_page}):
+
 ${appsInfo.join('\n\n')}`;
         return {
             content: [{ type: 'text', text }],

package/dist/tools/list-knowledge-categories.d.ts

@@ -0,0 +1,14 @@
+/**
+ * List Knowledge Categories Tool
+ *
+ * Lists all document categories in the user's knowledge base.
+ * Supports filtering by team or personal categories only.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const listKnowledgeCategoriesToolDef: Tool;
+export declare function handleListKnowledgeCategories(api: FlowDotApiClient, args?: {
+    team_id?: number;
+    personal?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=list-knowledge-categories.d.ts.map

package/dist/tools/list-knowledge-categories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-knowledge-categories.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge-categories.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,8BAA8B,EAAE,IAkB5C,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,gBAAgB,EACrB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9C,OAAO,CAAC,cAAc,CAAC,CAwFzB"}

package/dist/tools/list-knowledge-categories.js

@@ -0,0 +1,107 @@
+/**
+ * List Knowledge Categories Tool
+ *
+ * Lists all document categories in the user's knowledge base.
+ * Supports filtering by team or personal categories only.
+ */
+export const listKnowledgeCategoriesToolDef = {
+    name: 'list_knowledge_categories',
+    description: 'List all document categories in your knowledge base. Categories help organize documents for easier retrieval and targeted RAG queries. By default, shows both personal and team categories.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            team_id: {
+                type: 'number',
+                description: 'Optional: Filter to categories from a specific team only. Use list_user_teams to see available teams.',
+            },
+            personal: {
+                type: 'boolean',
+                description: 'Optional: Set to true to show only personal categories (excludes team categories).',
+            },
+        },
+        required: [],
+    },
+};
+export async function handleListKnowledgeCategories(api, args) {
+    try {
+        const categories = await api.listKnowledgeCategories({
+            team_id: args?.team_id,
+            personal: args?.personal,
+        });
+        if (categories.length === 0) {
+            let message = 'No knowledge base categories found.';
+            if (args?.team_id) {
+                message = `No categories found for team ID ${args.team_id}.`;
+            }
+            else if (args?.personal) {
+                message = 'No personal categories found.';
+            }
+            message += ' Use create_knowledge_category to create your first category.';
+            return {
+                content: [{ type: 'text', text: message }],
+            };
+        }
+        // Separate personal and team categories for display
+        const personalCategories = categories.filter(c => !c.team_id);
+        const teamCategories = categories.filter(c => c.team_id);
+        const lines = [
+            `## Knowledge Base Categories (${categories.length} total)`,
+            '',
+        ];
+        // Show personal categories
+        if (personalCategories.length > 0 && !args?.team_id) {
+            lines.push('### Personal Categories');
+            lines.push('');
+            for (const category of personalCategories) {
+                lines.push(`#### ${category.name}`);
+                lines.push(`- **ID:** ${category.id}`);
+                lines.push(`- **Slug:** ${category.slug}`);
+                if (category.description) {
+                    lines.push(`- **Description:** ${category.description}`);
+                }
+                lines.push(`- **Color:** ${category.color}`);
+                lines.push(`- **Documents:** ${category.document_count}`);
+                lines.push('');
+            }
+        }
+        // Show team categories
+        if (teamCategories.length > 0 && !args?.personal) {
+            // Group by team
+            const byTeam = new Map();
+            for (const cat of teamCategories) {
+                const teamId = cat.team_id;
+                if (!byTeam.has(teamId)) {
+                    byTeam.set(teamId, []);
+                }
+                byTeam.get(teamId).push(cat);
+            }
+            for (const [teamId, cats] of byTeam) {
+                const teamName = cats[0].team_name || `Team ${teamId}`;
+                lines.push(`### Team: ${teamName} (ID: ${teamId})`);
+                lines.push('');
+                for (const category of cats) {
+                    lines.push(`#### ${category.name}`);
+                    lines.push(`- **ID:** ${category.id}`);
+                    lines.push(`- **Slug:** ${category.slug}`);
+                    if (category.description) {
+                        lines.push(`- **Description:** ${category.description}`);
+                    }
+                    lines.push(`- **Color:** ${category.color}`);
+                    lines.push(`- **Documents:** ${category.document_count}`);
+                    lines.push('');
+                }
+            }
+        }
+        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 listing categories: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list-knowledge-categories.js.map

package/dist/tools/list-knowledge-categories.js.map

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

package/dist/tools/list-knowledge-documents.d.ts

@@ -0,0 +1,15 @@
+/**
+ * List Knowledge Documents Tool
+ *
+ * Lists documents in the user's knowledge base with optional filtering.
+ * Includes both personal and team documents.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const listKnowledgeDocumentsToolDef: Tool;
+export declare function handleListKnowledgeDocuments(api: FlowDotApiClient, args: {
+    category_id?: number;
+    team_id?: number | 'personal';
+    status?: 'pending' | 'processing' | 'ready' | 'failed';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=list-knowledge-documents.d.ts.map

package/dist/tools/list-knowledge-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-knowledge-documents.d.ts","sourceRoot":"","sources":["../../src/tools/list-knowledge-documents.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,6BAA6B,EAAE,IAuB3C,CAAC;AAEF,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC9B,MAAM,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;CACxD,GACA,OAAO,CAAC,cAAc,CAAC,CAyGzB"}