multi-app-mcp 1.0.0

package/plugins/quickreviewer/folders.js

@@ -0,0 +1,453 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// FOLDERS — Folder management tools
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { getAuthHeaders, requireLogin } from "./session.js";
+
+const QR_API_URL = process.env.QR_API_URL || "https://app.quickreviewer.com/api";
+
+// ─── Tool Definitions ─────────────────────────────────────────────────────────
+
+export const tools = [
+  {
+    name: "qr_get_folders",
+    description: "Get all folders of the logged-in user. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "qr_get_folder_tree",
+    description:
+      "Get full folder tree with documents inside. " +
+      "Use folderId=0 for root. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID (0 for root)" },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_get_folder_detail",
+    description: "Get details of a specific folder by folderId. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID" },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_get_folder_children",
+    description:
+      "Get all sub-folders inside a folder. " +
+      "Use parentId=0 for root level folders. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        parentId: { type: "integer", description: "Parent folder ID (0 for root)" },
+      },
+      required: ["parentId"],
+    },
+  },
+  {
+    name: "qr_create_folder",
+    description:
+      "Create a new folder. " +
+      "For root level folder use parentId=0, left=1, right=2, level=1, position=1. " +
+      "visibleToAll: 1 = visible to all, 0 = private. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderName:   { type: "string",  description: "Name of the new folder" },
+        parentId:     { type: "integer", description: "Parent folder ID (0 for root)" },
+        visibleToAll: { type: "integer", description: "1 = visible to all, 0 = private" },
+        left:         { type: "integer", description: "Tree left value (use 1 for root)" },
+        right:        { type: "integer", description: "Tree right value (use 2 for root)" },
+        level:        { type: "integer", description: "Folder depth level (1 for root)" },
+        position:     { type: "integer", description: "Position in folder list (start from 1)" },
+      },
+      required: ["folderName", "parentId", "visibleToAll", "left", "right", "level", "position"],
+    },
+  },
+  {
+    name: "qr_rename_folder",
+    description: "Rename a folder. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId:   { type: "integer", description: "Folder ID to rename" },
+        folderName: { type: "string",  description: "New folder name" },
+      },
+      required: ["folderId", "folderName"],
+    },
+  },
+  {
+    name: "qr_trash_folder",
+    description: "Move a folder to trash. User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of folder IDs to trash",
+        },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_delete_folder",
+    description:
+      "Delete a folder by moving it to trash first using qr_trash_folder. " +
+      "Always use qr_trash_folder instead of this tool — it is more reliable. " +
+      "This tool only removes folder from tree map, not from the actual folder list. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of folder IDs to delete",
+        },
+      },
+      required: ["folderId"],
+    },
+  },
+  {
+    name: "qr_share_folder",
+    description:
+      "Share a folder with someone via email. " +
+      "shareAction: 'view', 'comment', or 'approve'. " +
+      "download: 1 = allow, 0 = disallow. " +
+      "anybody: 1 = anyone with link, 0 = specific email only. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Array of folder IDs to share",
+        },
+        shareEmail:  { type: "string",  description: "Email address to share with" },
+        shareAction: { type: "string",  description: "Permission: 'view', 'comment', or 'approve'" },
+        download:    { type: "integer", description: "Allow download: 1 = yes, 0 = no" },
+        anybody:     { type: "integer", description: "Anyone with link: 1 = yes, 0 = no" },
+      },
+      required: ["folderId", "shareEmail", "shareAction", "download", "anybody"],
+    },
+  },
+  {
+    name: "qr_get_trashed_folders",
+    description:
+      "Get all trashed (deleted) folders of the logged-in user. " +
+      "Use folderId=0 to get all trashed folders. " +
+      "User must be logged in.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        folderId: { type: "integer", description: "Folder ID filter (0 = all trashed folders)" },
+      },
+      required: ["folderId"],
+    },
+  },
+];
+
+// ─── Handlers ─────────────────────────────────────────────────────────────────
+
+export const handlers = {
+
+  qr_get_folders: async () => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folders`, {
+      method:  "GET",
+      headers: getAuthHeaders(),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folders fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_folder_tree: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/get-tree`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder tree fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_folder_detail: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/folder-detail`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder detail fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_folder_children: async ({ parentId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/getchildren`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ parentId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Sub-folders fetched\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_create_folder: async ({ folderName, parentId, visibleToAll, left, right, level, position }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/create`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderName, parentId, visibleToAll, left, right, level, position }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder created successfully!\n\nName: ${folderName}\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_rename_folder: async ({ folderId, folderName }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/rnnode`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId, folderName }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder renamed successfully!\n\nNew name: ${folderName}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_trash_folder: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/trash`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder(s) moved to trash!\n\nFolder IDs: ${folderId.join(", ")}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_delete_folder: async ({ folderId }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/delete`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Folder(s) deleted permanently!\n\nFolder IDs: ${folderId.join(", ")}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_share_folder: async ({ folderId, shareEmail, shareAction, download, anybody }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/folder/share`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId, shareEmail, shareAction, download, anybody }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      return {
+        content: [{
+          type: "text",
+          text:
+            `✅ Folder shared successfully!\n\n` +
+            `Shared with: ${shareEmail}\n` +
+            `Permission: ${shareAction}\n` +
+            `Download allowed: ${download === 1 ? "Yes" : "No"}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+  qr_get_trashed_folders: async ({ folderId = 0 }) => {
+    const authError = requireLogin();
+    if (authError) return authError;
+
+    const res  = await fetch(`${QR_API_URL}/trashed-folder`, {
+      method:  "POST",
+      headers: getAuthHeaders(),
+      body:    JSON.stringify({ folderId }),
+    });
+    const data = await res.json();
+
+    if (res.ok) {
+      const items = Array.isArray(data) ? data : (data.rows || []);
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Trashed folders fetched (${items.length} items)\n\n${JSON.stringify(data, null, 2)}`,
+        }],
+      };
+    }
+    return {
+      content: [{
+        type: "text",
+        text: `❌ Failed (HTTP ${res.status})\n\n${JSON.stringify(data, null, 2)}`,
+      }],
+      isError: true,
+    };
+  },
+
+};

package/plugins/quickreviewer/index.js

@@ -0,0 +1,32 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// QUICKREVIEWER PLUGIN — Main entry point
+// Sab domain files ko combine karta hai
+// Naya domain add karna ho to:
+//   1. Nayi file banao (e.g. jira.js)
+//   2. Yahan import karo aur spread karo
+// ─────────────────────────────────────────────────────────────────────────────
+
+import { tools as authTools,      handlers as authHandlers      } from "./auth.js";
+import { tools as documentTools,  handlers as documentHandlers  } from "./documents.js";
+import { tools as folderTools,    handlers as folderHandlers    } from "./folders.js";
+import { tools as workflowTools,  handlers as workflowHandlers  } from "./workflows.js";
+import { tools as teamTools,      handlers as teamHandlers      } from "./teams.js";
+import { tools as uploadTools,    handlers as uploadHandlers    } from "./upload.js";
+
+export const tools = [
+  ...authTools,
+  ...documentTools,
+  ...folderTools,
+  ...workflowTools,
+  ...teamTools,
+  ...uploadTools,
+];
+
+export const handlers = {
+  ...authHandlers,
+  ...documentHandlers,
+  ...folderHandlers,
+  ...workflowHandlers,
+  ...teamHandlers,
+  ...uploadHandlers,
+};

package/plugins/quickreviewer/session.js

@@ -0,0 +1,30 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// SESSION — Shared in-memory token store
+// Sab plugin files yahan se import karti hain
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const session = {
+  token:     null,
+  userId:    null,
+  userName:  null,
+  userEmail: null,
+};
+
+export function getAuthHeaders() {
+  const baseUrl = (process.env.QR_API_URL || "https://app.quickreviewer.com/api").replace('/api', '');
+  return {
+    "Content-Type": "application/json",
+    "Referer": `${baseUrl}/`,
+    ...(session.token && { Authorization: `AUTH ${session.token}` }),
+  };
+}
+
+export function requireLogin() {
+  if (!session.token) {
+    return {
+      content: [{ type: "text", text: "❌ Not logged in. Please call qr_login first." }],
+      isError: true,
+    };
+  }
+  return null; // null means logged in — proceed
+}