44reports-mcp 1.0.7 → 1.0.8

package/dist/api-client.d.ts

@@ -46,6 +46,15 @@ export interface PulledFile {
     content_type: string;
     size: number;
 }
+export interface Folder {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    allowed_domains: string[];
+    created_at: string;
+    updated_at: string;
+}
 export declare class ApiClient {
     private readonly config;
     constructor(config: Config);
@@ -76,4 +85,36 @@ export declare class ApiClient {
     pullContextFiles(slug: string, filePaths?: string[]): Promise<{
         files: PulledFile[];
     }>;
+    listFolders(): Promise<{
+        folders: Folder[];
+    }>;
+    createFolder(data: {
+        name: string;
+        slug?: string;
+        description?: string;
+        allowed_domains: string[];
+    }): Promise<{
+        folder: Folder;
+    }>;
+    getFolder(slug: string): Promise<{
+        folder: Folder;
+        reports: Report[];
+    }>;
+    updateFolder(slug: string, data: {
+        name?: string;
+        description?: string;
+        allowed_domains?: string[];
+    }): Promise<{
+        folder: Folder;
+    }>;
+    deleteFolder(slug: string): Promise<{
+        success: boolean;
+    }>;
+    addReportsToFolder(slug: string, reportSlugs: string[]): Promise<{
+        added: string[];
+        not_found: string[];
+    }>;
+    removeReportFromFolder(folderSlug: string, reportSlug: string): Promise<{
+        success: boolean;
+    }>;
 }

package/dist/api-client.js

@@ -56,4 +56,38 @@ export class ApiClient {
             body: JSON.stringify({ files: filePaths }),
         });
     }
+    async listFolders() {
+        return this.request('/api/folders');
+    }
+    async createFolder(data) {
+        return this.request('/api/folders', {
+            method: 'POST',
+            body: JSON.stringify(data),
+        });
+    }
+    async getFolder(slug) {
+        return this.request(`/api/folders/${slug}`);
+    }
+    async updateFolder(slug, data) {
+        return this.request(`/api/folders/${slug}`, {
+            method: 'PUT',
+            body: JSON.stringify(data),
+        });
+    }
+    async deleteFolder(slug) {
+        return this.request(`/api/folders/${slug}`, {
+            method: 'DELETE',
+        });
+    }
+    async addReportsToFolder(slug, reportSlugs) {
+        return this.request(`/api/folders/${slug}/reports`, {
+            method: 'POST',
+            body: JSON.stringify({ report_slugs: reportSlugs }),
+        });
+    }
+    async removeReportFromFolder(folderSlug, reportSlug) {
+        return this.request(`/api/folders/${folderSlug}/reports/${reportSlug}`, {
+            method: 'DELETE',
+        });
+    }
 }

package/dist/index.js

@@ -7,6 +7,7 @@ import { ApiClient } from './api-client.js';
 import { deployReportSchema, updateReportSchema, createDeployTool, createUpdateTool, } from './tools/deploy.js';
 import { listReportsSchema, getReportSchema, deleteReportSchema, createListTool, createGetTool, createDeleteTool, } from './tools/reports.js';
 import { pullContextSchema, createPullTool, } from './tools/pull.js';
+import { manageFoldersSchema, createManageFoldersTool, } from './tools/folders.js';
 const config = loadConfig();
 const client = new ApiClient(config);
 function prop(type, description, extra = {}) {
@@ -113,6 +114,27 @@ const toolDefinitions = [
         schema: pullContextSchema,
         handler: createPullTool(client),
     },
+    {
+        name: 'manage_folders',
+        description: 'Manage folders for domain-scoped access control. Folders let you share specific contexts with external users by email domain (e.g., share investor reports with vgames.vc).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: prop('string', 'Action: list, create, get, update, delete, add_reports, remove_report', {
+                    enum: ['list', 'create', 'get', 'update', 'delete', 'add_reports', 'remove_report'],
+                }),
+                slug: prop('string', 'Folder slug (required for get/update/delete/add_reports/remove_report)'),
+                name: prop('string', 'Folder name (required for create)'),
+                description: prop('string', 'Folder description'),
+                allowed_domains: prop('array', 'Email domains that can access this folder (required for create)', { items: { type: 'string' } }),
+                report_slugs: prop('array', 'Report slugs to add to folder (for add_reports)', { items: { type: 'string' } }),
+                report_slug: prop('string', 'Report slug to remove (for remove_report)'),
+            },
+            required: ['action'],
+        },
+        schema: manageFoldersSchema,
+        handler: createManageFoldersTool(client),
+    },
 ];
 const toolHandlers = Object.fromEntries(toolDefinitions.map((t) => [t.name, { schema: t.schema, handler: t.handler }]));
 const server = new Server({ name: '44reports', version: '1.0.0' }, { capabilities: { tools: {} } });

package/dist/tools/folders.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { ApiClient } from '../api-client.js';
+export declare const manageFoldersSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "create", "get", "update", "delete", "add_reports", "remove_report"]>;
+    slug: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    report_slugs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    report_slug: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "list" | "create" | "get" | "update" | "delete" | "add_reports" | "remove_report";
+    name?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    allowed_domains?: string[] | undefined;
+    report_slugs?: string[] | undefined;
+    report_slug?: string | undefined;
+}, {
+    action: "list" | "create" | "get" | "update" | "delete" | "add_reports" | "remove_report";
+    name?: string | undefined;
+    slug?: string | undefined;
+    description?: string | undefined;
+    allowed_domains?: string[] | undefined;
+    report_slugs?: string[] | undefined;
+    report_slug?: string | undefined;
+}>;
+export declare function createManageFoldersTool(client: ApiClient): (input: z.infer<typeof manageFoldersSchema>) => Promise<{
+    folder: import("../api-client.js").Folder;
+} | {
+    added: string[];
+    not_found: string[];
+} | {
+    count: number;
+    folders: import("../api-client.js").Folder[];
+    success?: undefined;
+    message?: undefined;
+} | {
+    success: boolean;
+    message: string;
+    count?: undefined;
+    folders?: undefined;
+}>;

package/dist/tools/folders.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+export const manageFoldersSchema = z.object({
+    action: z.enum(['list', 'create', 'get', 'update', 'delete', 'add_reports', 'remove_report'])
+        .describe('Action to perform'),
+    slug: z.string().optional().describe('Folder slug (required for get, update, delete, add_reports, remove_report)'),
+    name: z.string().optional().describe('Folder name (required for create)'),
+    description: z.string().optional().describe('Folder description'),
+    allowed_domains: z.array(z.string()).optional().describe('Email domains that can access this folder (required for create)'),
+    report_slugs: z.array(z.string()).optional().describe('Report slugs to add (for add_reports action)'),
+    report_slug: z.string().optional().describe('Report slug to remove (for remove_report action)'),
+});
+export function createManageFoldersTool(client) {
+    return async (input) => {
+        switch (input.action) {
+            case 'list': {
+                const { folders } = await client.listFolders();
+                return { count: folders.length, folders };
+            }
+            case 'create': {
+                if (!input.name)
+                    throw new Error('name is required for create');
+                if (!input.allowed_domains || input.allowed_domains.length === 0) {
+                    throw new Error('allowed_domains is required for create');
+                }
+                return client.createFolder({
+                    name: input.name,
+                    slug: input.slug,
+                    description: input.description,
+                    allowed_domains: input.allowed_domains,
+                });
+            }
+            case 'get': {
+                if (!input.slug)
+                    throw new Error('slug is required for get');
+                return client.getFolder(input.slug);
+            }
+            case 'update': {
+                if (!input.slug)
+                    throw new Error('slug is required for update');
+                return client.updateFolder(input.slug, {
+                    name: input.name,
+                    description: input.description,
+                    allowed_domains: input.allowed_domains,
+                });
+            }
+            case 'delete': {
+                if (!input.slug)
+                    throw new Error('slug is required for delete');
+                await client.deleteFolder(input.slug);
+                return { success: true, message: `Folder "${input.slug}" deleted successfully` };
+            }
+            case 'add_reports': {
+                if (!input.slug)
+                    throw new Error('slug is required for add_reports');
+                if (!input.report_slugs || input.report_slugs.length === 0) {
+                    throw new Error('report_slugs is required for add_reports');
+                }
+                return client.addReportsToFolder(input.slug, input.report_slugs);
+            }
+            case 'remove_report': {
+                if (!input.slug)
+                    throw new Error('slug is required for remove_report');
+                if (!input.report_slug)
+                    throw new Error('report_slug is required for remove_report');
+                await client.removeReportFromFolder(input.slug, input.report_slug);
+                return { success: true, message: `Report "${input.report_slug}" removed from folder "${input.slug}"` };
+            }
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "44reports-mcp",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "description": "MCP server for deploying and pulling context files (code, docs, data) to/from 44reports",
   "main": "dist/index.js",