@flowdot.ai/mcp-server 1.0.0 → 1.0.1

package/dist/tools/unpublish-app.js

@@ -6,8 +6,8 @@
  */
 export const unpublishAppTool = {
     name: 'unpublish_app',
-    description: `Unpublish an app to make it private. The app will no longer be visible in the public marketplace.
-
+    description: `Unpublish an app to make it private. The app will no longer be visible in the public marketplace.
+
 Existing clones of your app will continue to work for their owners, but new users won't be able to discover or clone it.`,
     inputSchema: {
         type: 'object',

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

@@ -0,0 +1,11 @@
+/**
+ * update_app_file Tool
+ *
+ * Update an existing 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 updateAppFileTool: Tool;
+export declare function handleUpdateAppFile(client: FlowDotApiClient, args: Record<string, unknown>): Promise<CallToolResult>;
+//# sourceMappingURL=update-app-file.d.ts.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * update_app_file Tool
+ *
+ * Update an existing file in a multi-file FlowDot app.
+ * Required scope: apps:manage
+ */
+export const updateAppFileTool = {
+    name: 'update_app_file',
+    description: `Update the content of an existing file in a FlowDot app.
+
+Updates the file's content and optionally its type. Use this for making changes to existing files.
+
+For surgical edits (find/replace), consider using edit_app_code instead.
+
+File constraints:
+- Max file size: 100KB per file
+- Max total app size: 512KB across all files`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            app_id: {
+                type: 'string',
+                description: 'The app ID (hash)',
+            },
+            file_path: {
+                type: 'string',
+                description: 'The file path to update (e.g., "App.jsx", "components/Button.jsx")',
+            },
+            content: {
+                type: 'string',
+                description: 'The new file content',
+            },
+            type: {
+                type: 'string',
+                enum: ['component', 'hook', 'utility', 'page', 'context', 'style'],
+                description: 'The file type (optional)',
+            },
+        },
+        required: ['app_id', 'file_path', 'content'],
+    },
+};
+export async function handleUpdateAppFile(client, args) {
+    try {
+        const appId = String(args.app_id);
+        const filePath = String(args.file_path);
+        const input = {
+            content: String(args.content),
+        };
+        if (args.type) {
+            input.type = args.type;
+        }
+        const result = await client.updateAppFile(appId, filePath, input);
+        const text = `# File Updated Successfully
+
+**Path:** ${result.path}
+**Type:** ${result.type}
+**Entry Point:** ${result.is_entry ? 'Yes' : 'No'}
+**Updated:** ${result.updated_at}
+
+The file has been updated in app ${appId}.`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error updating app file: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=update-app-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-app-file.js","sourceRoot":"","sources":["../../src/tools/update-app-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE;;;;;;;;6CAQ8B;IAC3C,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,oEAAoE;aAClF;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBAClE,WAAW,EAAE,0BAA0B;aACxC;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC;KAC7C;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,KAAK,GAAuB;YAChC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;SAC9B,CAAC;QAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAkC,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAElE,MAAM,IAAI,GAAG;;YAEL,MAAM,CAAC,IAAI;YACX,MAAM,CAAC,IAAI;mBACJ,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;eAClC,MAAM,CAAC,UAAU;;mCAEG,KAAK,GAAG,CAAC;QAExC,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/update-app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-app.d.ts","sourceRoot":"","sources":["../../src/tools/update-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,IAqD3B,CAAC;AAEF,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmCzB"}
+{"version":3,"file":"update-app.d.ts","sourceRoot":"","sources":["../../src/tools/update-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,IA4D3B,CAAC;AAEF,wBAAsB,eAAe,CACnC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,cAAc,CAAC,CAmCzB"}

package/dist/tools/update-app.js

@@ -8,8 +8,15 @@ export const updateAppTool = {
     name: 'update_app',
     description: `Update an existing FlowDot app. You can update any combination of fields.
 
+CRITICAL: Remember these rules when updating code:
+- NO IMPORTS - React is global (use React.useState, etc.)
+- MUST include export default at the end: export default MyAppName;
+- NO FORM ELEMENTS - Never use <form> tags (sandbox blocks them)
+- ALL BUTTONS need type="button" attribute
+- Use getNodeOutput() helper to extract workflow results safely
+
 Use this to:
-- Update the React code (remember: NO imports, NO exports, use React.useState, etc.)
+- Update the React code
 - Change the name or description
 - Add/update mobile-specific code
 - Set display mode via config: { displayMode: "windowed" | "fullscreen" | "embedded" }

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

@@ -1 +1 @@
-{"version":3,"file":"update-app.js","sourceRoot":"","sources":["../../src/tools/update-app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-app.js","sourceRoot":"","sources":["../../src/tools/update-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;;;;;;;;2BAcY;IACzB,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6BAA6B;aAC3C;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sBAAsB;aACpC;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iBAAiB;aAC/B;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;aAClD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;aAC5C;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,cAAc;aAC5B;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,mCAAmC;aACjD;YACD,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,IAA6B;IAE7B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,OAAO,GAAmB,EAAE,CAAC;QAEnC,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnF,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAiC,CAAC;QACzE,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAgB,CAAC;QACpD,IAAI,OAAO,IAAI,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAEpG,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4DAA4D,EAAE,CAAC;gBAC/F,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEvC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,6CAA6C,aAAa,EAAE,EAAE,CAAC;SAC5G,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,uBAAuB,OAAO,EAAE,EAAE,CAAC;YACnE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Update Knowledge Category Tool
+ *
+ * Updates an existing document category.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const updateKnowledgeCategoryToolDef: Tool;
+export declare function handleUpdateKnowledgeCategory(api: FlowDotApiClient, args: {
+    category_id: number;
+    name?: string;
+    description?: string;
+    color?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=update-knowledge-category.d.ts.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * Update Knowledge Category Tool
+ *
+ * Updates an existing document category.
+ */
+export const updateKnowledgeCategoryToolDef = {
+    name: 'update_knowledge_category',
+    description: 'Update an existing knowledge base category name, description, or color.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            category_id: {
+                type: 'number',
+                description: 'The ID of the category to update',
+            },
+            name: {
+                type: 'string',
+                description: 'New name for the category (max 100 characters)',
+            },
+            description: {
+                type: 'string',
+                description: 'New description (max 500 characters)',
+            },
+            color: {
+                type: 'string',
+                description: 'New hex color code (e.g., #3B82F6)',
+                pattern: '^#[0-9A-Fa-f]{6}$',
+            },
+        },
+        required: ['category_id'],
+    },
+};
+export async function handleUpdateKnowledgeCategory(api, args) {
+    try {
+        const updates = {};
+        if (args.name !== undefined)
+            updates.name = args.name;
+        if (args.description !== undefined)
+            updates.description = args.description;
+        if (args.color !== undefined)
+            updates.color = args.color;
+        if (Object.keys(updates).length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No updates provided. Specify at least one of: name, description, or color.',
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const category = await api.updateKnowledgeCategory(args.category_id, updates);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Category "${category.name}" (ID: ${category.id}) updated successfully.\n\n` +
+                        `**Name:** ${category.name}\n` +
+                        `**Description:** ${category.description || 'None'}\n` +
+                        `**Color:** ${category.color}`,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            content: [{ type: 'text', text: `Error updating category: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=update-knowledge-category.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update-knowledge-category.js","sourceRoot":"","sources":["../../src/tools/update-knowledge-category.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,CAAC,MAAM,8BAA8B,GAAS;IAClD,IAAI,EAAE,2BAA2B;IACjC,WAAW,EAAE,yEAAyE;IACtF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;gBACjD,OAAO,EAAE,mBAAmB;aAC7B;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,GAAqB,EACrB,IAAkF;IAElF,IAAI,CAAC;QACH,MAAM,OAAO,GAA4D,EAAE,CAAC;QAC5E,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAC3E,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAEzD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4EAA4E;qBACnF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,uBAAuB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE9E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa,QAAQ,CAAC,IAAI,UAAU,QAAQ,CAAC,EAAE,6BAA6B;wBAChF,aAAa,QAAQ,CAAC,IAAI,IAAI;wBAC9B,oBAAoB,QAAQ,CAAC,WAAW,IAAI,MAAM,IAAI;wBACtD,cAAc,QAAQ,CAAC,KAAK,EAAE;iBACjC;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/upload-document-from-url.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Upload Document from URL Tool
+ *
+ * Downloads and uploads a document from a URL to the knowledge base.
+ * Can upload to personal or team knowledge base.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const uploadDocumentFromUrlToolDef: Tool;
+export declare function handleUploadDocumentFromUrl(api: FlowDotApiClient, args: {
+    url: string;
+    title?: string;
+    category_id?: number;
+    team_id?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=upload-document-from-url.d.ts.map

package/dist/tools/upload-document-from-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-document-from-url.d.ts","sourceRoot":"","sources":["../../src/tools/upload-document-from-url.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,4BAA4B,EAAE,IA0B1C,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/tools/upload-document-from-url.js

@@ -0,0 +1,73 @@
+/**
+ * Upload Document from URL Tool
+ *
+ * Downloads and uploads a document from a URL to the knowledge base.
+ * Can upload to personal or team knowledge base.
+ */
+export const uploadDocumentFromUrlToolDef = {
+    name: 'upload_document_from_url',
+    description: 'Download a document from a URL and add it to your knowledge base. Supports PDF, DOCX, TXT, Markdown, CSV, and JSON files (max 50MB). Can upload to personal or team knowledge base.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            url: {
+                type: 'string',
+                description: 'URL of the document to download',
+            },
+            title: {
+                type: 'string',
+                description: 'Optional: Title for the document (defaults to filename from URL)',
+            },
+            category_id: {
+                type: 'number',
+                description: 'Optional: Category ID to organize the document. Must belong to the same scope (personal or team).',
+            },
+            team_id: {
+                type: 'number',
+                description: 'Optional: Team ID to upload the document to. If omitted, uploads to personal knowledge base. Use list_user_teams to see available teams.',
+            },
+        },
+        required: ['url'],
+    },
+};
+export async function handleUploadDocumentFromUrl(api, args) {
+    try {
+        const result = await api.uploadDocumentFromUrl({
+            url: args.url,
+            title: args.title,
+            category_id: args.category_id,
+            team_id: args.team_id,
+        });
+        const lines = [
+            `## Document Downloaded Successfully`,
+            '',
+            `**Title:** ${result.title}`,
+            `**ID:** ${result.id}`,
+            `**Hash:** ${result.hash}`,
+            result.original_filename ? `**Filename:** ${result.original_filename}` : '',
+            result.file_size_bytes ? `**Size:** ${(result.file_size_bytes / 1024).toFixed(1)} KB` : '',
+            `**Status:** ${result.status}`,
+        ].filter(Boolean);
+        if (args.team_id) {
+            lines.push(`**Location:** Team knowledge base (Team ID: ${args.team_id})`);
+        }
+        else {
+            lines.push(`**Location:** Personal knowledge base`);
+        }
+        lines.push('');
+        lines.push(result.message || 'Document downloaded and queued for processing.');
+        lines.push('');
+        lines.push('The document will be processed in the background. Use list_knowledge_documents to check the status.');
+        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 uploading document from URL: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=upload-document-from-url.js.map

package/dist/tools/upload-document-from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-document-from-url.js","sourceRoot":"","sources":["../../src/tools/upload-document-from-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,4BAA4B,GAAS;IAChD,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,qLAAqL;IACvL,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kEAAkE;aAChF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mGAAmG;aACjH;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0IAA0I;aACxJ;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,CAAC;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAqB,EACrB,IAA6E;IAE7E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,qBAAqB,CAAC;YAC7C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,qCAAqC;YACrC,EAAE;YACF,cAAc,MAAM,CAAC,KAAK,EAAE;YAC5B,WAAW,MAAM,CAAC,EAAE,EAAE;YACtB,aAAa,MAAM,CAAC,IAAI,EAAE;YAC1B,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE;YAC3E,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC1F,eAAe,MAAM,CAAC,MAAM,EAAE;SAC/B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAElB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,+CAA+C,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC7E,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,MAAM,CAAC,OAAO,IAAI,gDAAgD,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qGAAqG,CAAC,CAAC;QAElH,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,sCAAsC,OAAO,EAAE,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/upload-text-document.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Upload Text Document Tool
+ *
+ * Uploads text content directly as a document to the knowledge base.
+ * Can upload to personal or team knowledge base.
+ */
+import { Tool, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { FlowDotApiClient } from '../api-client.js';
+export declare const uploadTextDocumentToolDef: Tool;
+export declare function handleUploadTextDocument(api: FlowDotApiClient, args: {
+    title: string;
+    content: string;
+    category_id?: number;
+    team_id?: number;
+    mime_type?: 'text/plain' | 'text/markdown' | 'application/json';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=upload-text-document.d.ts.map

package/dist/tools/upload-text-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-text-document.d.ts","sourceRoot":"","sources":["../../src/tools/upload-text-document.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,yBAAyB,EAAE,IA+BvC,CAAC;AAEF,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE;IACJ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,GAAG,eAAe,GAAG,kBAAkB,CAAC;CACjE,GACA,OAAO,CAAC,cAAc,CAAC,CAwCzB"}

package/dist/tools/upload-text-document.js

@@ -0,0 +1,77 @@
+/**
+ * Upload Text Document Tool
+ *
+ * Uploads text content directly as a document to the knowledge base.
+ * Can upload to personal or team knowledge base.
+ */
+export const uploadTextDocumentToolDef = {
+    name: 'upload_text_document',
+    description: 'Upload text content directly as a document to your knowledge base. Ideal for creating documents from AI-generated content, notes, or any text. The document will be processed and chunked for RAG queries. Can upload to personal or team knowledge base.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            title: {
+                type: 'string',
+                description: 'Title for the document (max 255 characters)',
+            },
+            content: {
+                type: 'string',
+                description: 'The text content to upload (max 10MB)',
+            },
+            category_id: {
+                type: 'number',
+                description: 'Optional: Category ID to organize the document. Must belong to the same scope (personal or team).',
+            },
+            team_id: {
+                type: 'number',
+                description: 'Optional: Team ID to upload the document to. If omitted, uploads to personal knowledge base. Use list_user_teams to see available teams.',
+            },
+            mime_type: {
+                type: 'string',
+                enum: ['text/plain', 'text/markdown', 'application/json'],
+                description: 'Content type: text/plain (default), text/markdown, or application/json',
+            },
+        },
+        required: ['title', 'content'],
+    },
+};
+export async function handleUploadTextDocument(api, args) {
+    try {
+        const result = await api.uploadTextDocument({
+            title: args.title,
+            content: args.content,
+            category_id: args.category_id,
+            team_id: args.team_id,
+            mime_type: args.mime_type,
+        });
+        const lines = [
+            `## Document Uploaded Successfully`,
+            '',
+            `**Title:** ${result.title}`,
+            `**ID:** ${result.id}`,
+            `**Hash:** ${result.hash}`,
+            `**Status:** ${result.status}`,
+        ];
+        if (args.team_id) {
+            lines.push(`**Location:** Team knowledge base (Team ID: ${args.team_id})`);
+        }
+        else {
+            lines.push(`**Location:** Personal knowledge base`);
+        }
+        lines.push('');
+        lines.push(result.message || 'Document created and queued for processing.');
+        lines.push('');
+        lines.push('The document will be processed in the background. Use list_knowledge_documents to check the status.');
+        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 uploading document: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=upload-text-document.js.map

package/dist/tools/upload-text-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-text-document.js","sourceRoot":"","sources":["../../src/tools/upload-text-document.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,yBAAyB,GAAS;IAC7C,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,2PAA2P;IAC7P,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mGAAmG;aACjH;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0IAA0I;aACxJ;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,EAAE,kBAAkB,CAAC;gBACzD,WAAW,EAAE,wEAAwE;aACtF;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;KAC/B;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAqB,EACrB,IAMC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC;YAC1C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG;YACZ,mCAAmC;YACnC,EAAE;YACF,cAAc,MAAM,CAAC,KAAK,EAAE;YAC5B,WAAW,MAAM,CAAC,EAAE,EAAE;YACtB,aAAa,MAAM,CAAC,IAAI,EAAE;YAC1B,eAAe,MAAM,CAAC,MAAM,EAAE;SAC/B,CAAC;QAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,+CAA+C,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QAC7E,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,MAAM,CAAC,OAAO,IAAI,6CAA6C,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qGAAqG,CAAC,CAAC;QAElH,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,6BAA6B,OAAO,EAAE,EAAE,CAAC;YACzE,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}