@tuskydp/cli 0.1.0

package/dist/src/mcp/tools/files.js

@@ -0,0 +1,310 @@
+/**
+ * MCP tools — File operations
+ *
+ * Handles upload with client-side encryption for private vaults,
+ * download with decryption and rehydration polling for cold files.
+ */
+import { z } from 'zod';
+import { readFileSync, writeFileSync, statSync } from 'fs';
+import { basename, resolve } from 'path';
+import { lookup } from 'mime-types';
+import { encryptBuffer, decryptBuffer } from '../../crypto.js';
+import { wrapToolError } from './helpers.js';
+// ---------------------------------------------------------------------------
+// Shared helpers
+// ---------------------------------------------------------------------------
+/** MIME types that should be returned as text rather than base64. */
+function isTextMimeType(mimeType) {
+    if (mimeType.startsWith('text/'))
+        return true;
+    const textTypes = [
+        'application/json',
+        'application/xml',
+        'application/javascript',
+        'application/typescript',
+        'application/x-yaml',
+        'application/yaml',
+        'application/toml',
+        'application/x-sh',
+        'application/sql',
+        'application/graphql',
+        'application/xhtml+xml',
+        'application/svg+xml',
+        'application/x-httpd-php',
+    ];
+    return textTypes.includes(mimeType) || mimeType.endsWith('+json') || mimeType.endsWith('+xml');
+}
+/**
+ * Fetch a file from Tusky, handle rehydration polling and decryption.
+ * Returns the plaintext buffer and encryption info.
+ */
+async function fetchAndDecryptFile(fileId, ctx) {
+    let dlResponse = await ctx.sdk.files.getDownloadUrl(fileId);
+    let { downloadUrl, status, encryption } = dlResponse;
+    // Handle rehydration from Walrus (cold files)
+    if (status === 'rehydrating') {
+        for (let i = 0; i < 30; i++) {
+            await new Promise((r) => setTimeout(r, 2000));
+            const check = await ctx.sdk.files.getDownloadUrl(fileId);
+            if (check.status === 'ready') {
+                downloadUrl = check.downloadUrl;
+                encryption = check.encryption;
+                status = 'ready';
+                break;
+            }
+        }
+        if (status !== 'ready') {
+            throw new Error('File rehydration timed out (60s). The file is being retrieved from Walrus. Try again later.');
+        }
+    }
+    if (!downloadUrl) {
+        throw new Error('No download URL available for this file.');
+    }
+    // Download
+    const response = await fetch(downloadUrl);
+    if (!response.ok) {
+        throw new Error(`Download failed: HTTP ${response.status}`);
+    }
+    const arrayBuf = await response.arrayBuffer();
+    let fileBuffer = Buffer.from(arrayBuf);
+    // Decrypt if needed
+    if (encryption?.encrypted) {
+        const masterKey = ctx.getMasterKey();
+        if (!masterKey) {
+            throw new Error('Encryption passphrase required to decrypt this file. ' +
+                'Set the TUSKYDP_PASSWORD environment variable in your MCP server config.');
+        }
+        fileBuffer = decryptBuffer(fileBuffer, encryption.wrappedKey, encryption.iv, masterKey, encryption.plaintextChecksumSha256 ?? undefined);
+    }
+    return { fileBuffer, encryption };
+}
+/**
+ * Encrypt (if private vault) and upload a buffer to Tusky.
+ * Shared by tusky_file_upload (from disk) and tusky_file_create (from content).
+ */
+async function encryptAndUpload(fileBuffer, fileName, mimeType, vaultId, folderId, ctx) {
+    const vault = await ctx.sdk.vaults.get(vaultId);
+    const isPrivate = vault.visibility === 'private';
+    let uploadBody;
+    let encryptionMeta = {};
+    if (isPrivate) {
+        const masterKey = ctx.getMasterKey();
+        if (!masterKey) {
+            throw new Error('Encryption passphrase required for private vault uploads. ' +
+                'Set the TUSKYDP_PASSWORD environment variable in your MCP server config.');
+        }
+        const { ciphertext, wrappedKey, iv, plaintextChecksum } = encryptBuffer(fileBuffer, masterKey);
+        uploadBody = ciphertext;
+        encryptionMeta = {
+            wrappedKey,
+            encryptionIv: iv,
+            plaintextSizeBytes: fileBuffer.length,
+            plaintextChecksumSha256: plaintextChecksum,
+        };
+    }
+    else {
+        uploadBody = fileBuffer;
+    }
+    // Request presigned upload URL
+    const { fileId, uploadUrl } = await ctx.sdk.files.requestUpload({
+        name: fileName,
+        mimeType,
+        sizeBytes: uploadBody.length,
+        vaultId,
+        folderId,
+        ...encryptionMeta,
+    });
+    // PUT to presigned URL
+    const putRes = await fetch(uploadUrl, {
+        method: 'PUT',
+        headers: { 'Content-Type': 'application/octet-stream' },
+        body: new Uint8Array(uploadBody),
+    });
+    if (!putRes.ok) {
+        const errText = await putRes.text().catch(() => putRes.statusText);
+        throw new Error(`Upload PUT failed (${putRes.status}): ${errText}`);
+    }
+    // Confirm upload
+    const file = await ctx.sdk.files.confirmUpload(fileId);
+    return { file, isPrivate, uploadedSizeBytes: uploadBody.length };
+}
+// ---------------------------------------------------------------------------
+// Tool registration
+// ---------------------------------------------------------------------------
+export function registerFileTools(server, ctx) {
+    // ── Upload file from disk ──────────────────────────────────────────────
+    server.tool('tusky_file_upload', 'Upload a file from a local filesystem path to a vault. Handles encryption transparently for private vaults. Use tusky_file_create instead if you want to upload content directly without a file on disk.', {
+        filePath: z.string().describe('Absolute or relative path to the local file to upload'),
+        vaultId: z.string().describe('Target vault ID'),
+        folderId: z.string().optional().describe('Target folder ID within the vault (omit for vault root)'),
+    }, async ({ filePath, vaultId, folderId }) => {
+        try {
+            const resolvedPath = resolve(filePath);
+            // Validate file exists
+            let stat;
+            try {
+                stat = statSync(resolvedPath);
+            }
+            catch {
+                return wrapToolError(new Error(`File not found: ${resolvedPath}`));
+            }
+            if (!stat.isFile()) {
+                return wrapToolError(new Error(`Not a file: ${resolvedPath}`));
+            }
+            const fileBuffer = readFileSync(resolvedPath);
+            const fileName = basename(resolvedPath);
+            const mimeType = lookup(resolvedPath) || 'application/octet-stream';
+            const { file, isPrivate, uploadedSizeBytes } = await encryptAndUpload(fileBuffer, fileName, mimeType, vaultId, folderId, ctx);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({
+                            ...file,
+                            localPath: resolvedPath,
+                            encrypted: isPrivate,
+                            uploadedSizeBytes,
+                        }, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Create file from content ─────────────────────────────────────────
+    server.tool('tusky_file_create', 'Create a file in a vault from raw content (text or base64-encoded binary). Use this when you want to upload content directly without needing a file on disk. Handles encryption transparently for private vaults.', {
+        name: z.string().describe('File name including extension (e.g. "report.md", "data.json", "image.png")'),
+        content: z.string().describe('File content: plain text for text files, or base64-encoded string for binary files'),
+        encoding: z.enum(['utf-8', 'base64']).optional().describe('Content encoding. "utf-8" (default) for text content, "base64" for binary content.'),
+        vaultId: z.string().describe('Target vault ID'),
+        folderId: z.string().optional().describe('Target folder ID within the vault (omit for vault root)'),
+    }, async ({ name, content, encoding, vaultId, folderId }) => {
+        try {
+            const enc = encoding ?? 'utf-8';
+            const fileBuffer = enc === 'base64'
+                ? Buffer.from(content, 'base64')
+                : Buffer.from(content, 'utf-8');
+            const mimeType = lookup(name) || 'application/octet-stream';
+            const { file, isPrivate, uploadedSizeBytes } = await encryptAndUpload(fileBuffer, name, mimeType, vaultId, folderId, ctx);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({
+                            ...file,
+                            encrypted: isPrivate,
+                            uploadedSizeBytes,
+                        }, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Download file (to disk) ────────────────────────────────────────────
+    server.tool('tusky_file_download', 'Download a file by ID and save it to a local path on disk. Handles decryption for private vaults and rehydration for cold files. Use tusky_file_read instead if you just want the file content returned directly.', {
+        fileId: z.string().describe('File ID to download'),
+        outputPath: z.string().describe('Local path to save the file (must be writable)'),
+    }, async ({ fileId, outputPath }) => {
+        try {
+            const { fileBuffer, encryption } = await fetchAndDecryptFile(fileId, ctx);
+            const fileInfo = await ctx.sdk.files.getStatus(fileId);
+            const finalPath = resolve(outputPath);
+            writeFileSync(finalPath, fileBuffer);
+            const result = {
+                fileId,
+                name: fileInfo.name,
+                savedTo: finalPath,
+                sizeBytes: fileBuffer.length,
+                mimeType: fileInfo.mimeType,
+                wasEncrypted: encryption?.encrypted ?? false,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Read file content (inline) ───────────────────────────────────────
+    server.tool('tusky_file_read', 'Read a file\'s content and return it directly. For text files the content is returned as text. For binary files it is returned as base64. Handles decryption for private vaults and rehydration for cold files transparently. Prefer this over tusky_file_download when you need to inspect file content.', {
+        fileId: z.string().describe('File ID to read'),
+    }, async ({ fileId }) => {
+        try {
+            const { fileBuffer, encryption } = await fetchAndDecryptFile(fileId, ctx);
+            const fileInfo = await ctx.sdk.files.getStatus(fileId);
+            const isText = isTextMimeType(fileInfo.mimeType);
+            if (isText) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `--- ${fileInfo.name} (${fileInfo.mimeType}, ${fileBuffer.length} bytes${encryption?.encrypted ? ', decrypted' : ''}) ---\n\n${fileBuffer.toString('utf-8')}`,
+                        },
+                    ],
+                };
+            }
+            // Binary file — return as base64
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            fileId,
+                            name: fileInfo.name,
+                            mimeType: fileInfo.mimeType,
+                            sizeBytes: fileBuffer.length,
+                            wasEncrypted: encryption?.encrypted ?? false,
+                            encoding: 'base64',
+                            data: fileBuffer.toString('base64'),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── List files ───────────────────────────────────────────────────────
+    server.tool('tusky_file_list', 'List files, optionally filtered by vault or folder. Returns file metadata including status.', {
+        vaultId: z.string().optional().describe('Filter by vault ID'),
+        folderId: z.string().optional().describe('Filter by folder ID'),
+        limit: z.number().optional().describe('Max number of files to return (default 50)'),
+        cursor: z.string().optional().describe('Pagination cursor from a previous response'),
+    }, async ({ vaultId, folderId, limit, cursor }) => {
+        try {
+            const result = await ctx.sdk.files.list({ vaultId, folderId, limit, cursor });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Get file info ────────────────────────────────────────────────────
+    server.tool('tusky_file_get', 'Get detailed metadata for a specific file by ID', {
+        fileId: z.string().describe('File ID'),
+    }, async ({ fileId }) => {
+        try {
+            const file = await ctx.sdk.files.get(fileId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(file, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Delete file ──────────────────────────────────────────────────────
+    server.tool('tusky_file_delete', 'Soft-delete a file (moves to trash). Can be restored within 7 days.', {
+        fileId: z.string().describe('File ID to delete'),
+    }, async ({ fileId }) => {
+        try {
+            await ctx.sdk.files.delete(fileId);
+            return {
+                content: [{ type: 'text', text: `File ${fileId} moved to trash.` }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=files.js.map

package/dist/src/mcp/tools/files.js.map

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

package/dist/src/mcp/tools/folders.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools — Folder management
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpContext } from '../context.js';
+export declare function registerFolderTools(server: McpServer, ctx: McpContext): void;
+//# sourceMappingURL=folders.d.ts.map

package/dist/src/mcp/tools/folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"folders.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/folders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,QA+ErE"}

package/dist/src/mcp/tools/folders.js

@@ -0,0 +1,67 @@
+/**
+ * MCP tools — Folder management
+ */
+import { z } from 'zod';
+import { wrapToolError } from './helpers.js';
+export function registerFolderTools(server, ctx) {
+    // ── Create folder ────────────────────────────────────────────────────
+    server.tool('tusky_folder_create', 'Create a folder inside a vault', {
+        vaultId: z.string().describe('Vault ID'),
+        name: z.string().describe('Folder name'),
+        parentId: z.string().optional().describe('Parent folder ID (omit for root)'),
+    }, async ({ vaultId, name, parentId }) => {
+        try {
+            const folder = await ctx.sdk.folders.create({ vaultId, name, parentId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(folder, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── List folders ─────────────────────────────────────────────────────
+    server.tool('tusky_folder_list', 'List folders in a vault (optionally within a parent folder)', {
+        vaultId: z.string().describe('Vault ID'),
+        parentId: z.string().optional().describe('Parent folder ID (omit for root-level folders)'),
+    }, async ({ vaultId, parentId }) => {
+        try {
+            const folders = await ctx.sdk.folders.list({ vaultId, parentId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(folders, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Get folder contents ──────────────────────────────────────────────
+    server.tool('tusky_folder_get_contents', 'Get the contents (files and subfolders) of a folder', {
+        folderId: z.string().describe('Folder ID'),
+    }, async ({ folderId }) => {
+        try {
+            const contents = await ctx.sdk.folders.getContents(folderId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(contents, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Delete folder ────────────────────────────────────────────────────
+    server.tool('tusky_folder_delete', 'Delete a folder', {
+        folderId: z.string().describe('Folder ID'),
+    }, async ({ folderId }) => {
+        try {
+            await ctx.sdk.folders.delete(folderId);
+            return {
+                content: [{ type: 'text', text: `Folder ${folderId} deleted successfully.` }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=folders.js.map

package/dist/src/mcp/tools/folders.js.map

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

package/dist/src/mcp/tools/helpers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared helpers for MCP tool handlers.
+ */
+/**
+ * Wraps an error into an MCP tool error result.
+ * Extracts meaningful messages from TuskyError or generic Error instances.
+ */
+export declare function wrapToolError(err: unknown): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError: true;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/src/mcp/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG;IAC3C,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,EAAE,IAAI,CAAC;CACf,CAcA"}

package/dist/src/mcp/tools/helpers.js

@@ -0,0 +1,25 @@
+/**
+ * Shared helpers for MCP tool handlers.
+ */
+import { TuskyError } from '@tuskydp/sdk';
+/**
+ * Wraps an error into an MCP tool error result.
+ * Extracts meaningful messages from TuskyError or generic Error instances.
+ */
+export function wrapToolError(err) {
+    let message;
+    if (err instanceof TuskyError) {
+        message = `Tusky API error (${err.statusCode}): ${err.message}`;
+    }
+    else if (err instanceof Error) {
+        message = err.message;
+    }
+    else {
+        message = String(err);
+    }
+    return {
+        content: [{ type: 'text', text: message }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/mcp/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/mcp/tools/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IAIxC,IAAI,OAAe,CAAC;IACpB,IAAI,GAAG,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,GAAG,oBAAoB,GAAG,CAAC,UAAU,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/trash.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools — Trash management
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpContext } from '../context.js';
+export declare function registerTrashTools(server: McpServer, ctx: McpContext): void;
+//# sourceMappingURL=trash.d.ts.map

package/dist/src/mcp/tools/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/trash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,QAqDpE"}

package/dist/src/mcp/tools/trash.js

@@ -0,0 +1,46 @@
+/**
+ * MCP tools — Trash management
+ */
+import { z } from 'zod';
+import { wrapToolError } from './helpers.js';
+export function registerTrashTools(server, ctx) {
+    // ── List trash ───────────────────────────────────────────────────────
+    server.tool('tusky_trash_list', 'List all soft-deleted files and vaults in the trash', {}, async () => {
+        try {
+            const trash = await ctx.sdk.trash.list();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(trash, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Restore from trash ───────────────────────────────────────────────
+    server.tool('tusky_trash_restore', 'Restore a file or vault from the trash', {
+        id: z.string().describe('ID of the trashed file or vault to restore'),
+    }, async ({ id }) => {
+        try {
+            const result = await ctx.sdk.trash.restore(id);
+            return {
+                content: [{ type: 'text', text: `Restored ${result.type ?? 'item'} ${id} successfully.` }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Empty trash ──────────────────────────────────────────────────────
+    server.tool('tusky_trash_empty', 'Permanently delete ALL items in the trash. This action cannot be undone.', {}, async () => {
+        try {
+            await ctx.sdk.trash.empty();
+            return {
+                content: [{ type: 'text', text: 'Trash emptied successfully. All items permanently deleted.' }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=trash.js.map

package/dist/src/mcp/tools/trash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.js","sourceRoot":"","sources":["../../../../src/mcp/tools/trash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,GAAe;IACnE,wEAAwE;IACxE,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,qDAAqD,EACrD,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,wEAAwE;IACxE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,wCAAwC,EACxC;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACtE,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC/C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,MAAM,CAAC,IAAI,IAAI,MAAM,IAAI,EAAE,gBAAgB,EAAE,CAAC;aACpG,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;IAEF,wEAAwE;IACxE,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,0EAA0E,EAC1E,EAAE,EACF,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4DAA4D,EAAE,CAAC;aACzG,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/src/mcp/tools/vaults.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MCP tools — Vault management
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { McpContext } from '../context.js';
+export declare function registerVaultTools(server: McpServer, ctx: McpContext): void;
+//# sourceMappingURL=vaults.d.ts.map

package/dist/src/mcp/tools/vaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vaults.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/vaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,QAwGpE"}

package/dist/src/mcp/tools/vaults.js

@@ -0,0 +1,85 @@
+/**
+ * MCP tools — Vault management
+ */
+import { z } from 'zod';
+import { wrapToolError } from './helpers.js';
+export function registerVaultTools(server, ctx) {
+    // ── Create vault ─────────────────────────────────────────────────────
+    server.tool('tusky_vault_create', 'Create a new storage vault. Visibility is immutable after creation.', {
+        name: z.string().describe('Vault name'),
+        description: z.string().optional().describe('Vault description'),
+        visibility: z.enum(['public', 'private']).optional().describe('Vault visibility. "private" enables client-side encryption. Defaults to "private".'),
+    }, async ({ name, description, visibility }) => {
+        try {
+            const vault = await ctx.sdk.vaults.create({
+                name,
+                description,
+                visibility: visibility ?? 'private',
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(vault, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── List vaults ──────────────────────────────────────────────────────
+    server.tool('tusky_vault_list', 'List all vaults in the account', {}, async () => {
+        try {
+            const vaults = await ctx.sdk.vaults.list();
+            return {
+                content: [{ type: 'text', text: JSON.stringify(vaults, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Get vault ────────────────────────────────────────────────────────
+    server.tool('tusky_vault_get', 'Get details of a specific vault by ID', {
+        vaultId: z.string().describe('Vault ID'),
+    }, async ({ vaultId }) => {
+        try {
+            const vault = await ctx.sdk.vaults.get(vaultId);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(vault, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Update vault ─────────────────────────────────────────────────────
+    server.tool('tusky_vault_update', 'Update a vault name or description (visibility cannot be changed)', {
+        vaultId: z.string().describe('Vault ID'),
+        name: z.string().optional().describe('New vault name'),
+        description: z.string().optional().describe('New vault description'),
+    }, async ({ vaultId, name, description }) => {
+        try {
+            const vault = await ctx.sdk.vaults.update(vaultId, { name, description });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(vault, null, 2) }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+    // ── Delete vault ─────────────────────────────────────────────────────
+    server.tool('tusky_vault_delete', 'Delete a vault. Use force=true to delete even if the vault contains files.', {
+        vaultId: z.string().describe('Vault ID'),
+        force: z.boolean().optional().describe('Force delete even if vault contains files'),
+    }, async ({ vaultId, force }) => {
+        try {
+            await ctx.sdk.vaults.delete(vaultId, { force });
+            return {
+                content: [{ type: 'text', text: `Vault ${vaultId} deleted successfully.` }],
+            };
+        }
+        catch (err) {
+            return wrapToolError(err);
+        }
+    });
+}
+//# sourceMappingURL=vaults.js.map

package/dist/src/mcp/tools/vaults.js.map

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