@tacitai/mcp-server 0.1.1 → 0.3.0

package/dist/tools/lake-structure.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TacitClient } from '../client.js';
+export declare function registerLakeStructureTools(server: McpServer, getClient: () => Promise<TacitClient>): void;

package/dist/tools/lake-structure.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { TacitApiError } from '../client.js';
+import { success, error } from './errors.js';
+export function registerLakeStructureTools(server, getClient) {
+    server.tool('tacit_lake_propose_structure', 'Generate a v7 structure proposal for a registered source. Does NOT modify the repo.', {
+        source_id: z.string().uuid().describe('Source ID to generate proposal for'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const data = await client.request('POST', `/api/v1/org/lake/sources/${args.source_id}/propose-structure`);
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_apply_structure', 'Apply a previously proposed v7 structure via atomic git commit. Idempotent: re-applying returns 409.', {
+        source_id: z.string().uuid().describe('Source ID the proposal belongs to'),
+        proposal_id: z.string().uuid().describe('Proposal ID to apply'),
+        excluded_moves: z.array(z.string().uuid()).optional().describe('Catalog IDs to exclude from restructuring'),
+        reassignments: z.record(z.string(), z.string()).optional().describe('Map of catalog_id → target_folder for reassignments'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const body = { proposal_id: args.proposal_id };
+            if (args.excluded_moves && args.excluded_moves.length > 0)
+                body.excluded_moves = args.excluded_moves;
+            if (args.reassignments && Object.keys(args.reassignments).length > 0)
+                body.reassignments = args.reassignments;
+            const data = await client.request('POST', `/api/v1/org/lake/sources/${args.source_id}/apply-structure`, body);
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_folder_list', 'List the folder schema for a data lake source.', {
+        source_id: z.string().uuid().describe('Source ID to list folder schema for'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const data = await client.request('GET', `/api/v1/org/lake/sources/${args.source_id}/folders`);
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_folder_add', "Add a custom folder to a source's schema.", {
+        source_id: z.string().uuid().describe('Source ID to add folder to'),
+        name: z.string().describe("New folder's name"),
+        subject_prefixes: z.array(z.string()).describe('Subject prefixes that route files into this folder'),
+        description: z.string().optional().describe('Folder description'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const body = {
+                name: args.name,
+                subject_prefixes: args.subject_prefixes,
+            };
+            if (args.description !== undefined)
+                body.description = args.description;
+            const data = await client.request('POST', `/api/v1/org/lake/sources/${args.source_id}/folders`, body);
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_folder_remove', 'Remove a folder and redistribute contents to another folder.', {
+        source_id: z.string().uuid().describe('Source ID'),
+        folder_name: z.string().describe('Folder name to remove'),
+        redistribute_to: z.string().describe('Folder to receive removed contents'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const data = await client.request('DELETE', `/api/v1/org/lake/sources/${args.source_id}/folders/${args.folder_name}`, { redistribute_to: args.redistribute_to });
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_folder_rename', "Rename a folder in a source's schema.", {
+        source_id: z.string().uuid().describe('Source ID'),
+        folder_name: z.string().describe('Current folder name'),
+        new_name: z.string().describe('New folder name'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const data = await client.request('PUT', `/api/v1/org/lake/sources/${args.source_id}/folders/${args.folder_name}`, { new_name: args.new_name });
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+    server.tool('tacit_lake_folder_merge', 'Merge one folder into another — combines subject prefixes and moves contents.', {
+        source_id: z.string().uuid().describe('Source ID'),
+        source_folder: z.string().describe('Folder to merge from'),
+        target_folder: z.string().describe('Folder to merge into'),
+    }, async (args) => {
+        try {
+            const client = await getClient();
+            const data = await client.request('POST', `/api/v1/org/lake/sources/${args.source_id}/folders/merge`, { source_folder: args.source_folder, target_folder: args.target_folder });
+            return success(data);
+        }
+        catch (e) {
+            if (e instanceof TacitApiError)
+                return error(e.message);
+            return error(`Unexpected error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    });
+}