@zeliper/zscode-mcp-server 1.0.8 → 2.0.0

package/dist/tools/navigate.js

@@ -0,0 +1,334 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { withErrorHandling, ProjectNotInitializedError, } from "../errors/index.js";
+// ============ Human-Readable Formatters ============
+function formatPlansList(result) {
+    const lines = [];
+    const { items, pagination } = result;
+    lines.push(`📋 **Plans** (${pagination.page}/${pagination.totalPages}, total: ${pagination.totalItems})`);
+    lines.push("");
+    if (items.length === 0) {
+        lines.push("No plans found.");
+        return lines.join("\n");
+    }
+    for (const plan of items) {
+        const statusIcon = getStatusIcon(plan.status);
+        lines.push(`${statusIcon} **${plan.title}** (${plan.id})`);
+        lines.push(`   Status: ${plan.status} | Stagings: ${plan.stagings.length}`);
+        if (plan.description) {
+            lines.push(`   ${plan.description.substring(0, 80)}${plan.description.length > 80 ? "..." : ""}`);
+        }
+        lines.push("");
+    }
+    if (pagination.hasNext) {
+        lines.push(`📄 Next page: ${pagination.page + 1}`);
+    }
+    return lines.join("\n");
+}
+function formatTasksList(result) {
+    const lines = [];
+    const { items, pagination } = result;
+    lines.push(`✅ **Tasks** (${pagination.page}/${pagination.totalPages}, total: ${pagination.totalItems})`);
+    lines.push("");
+    if (items.length === 0) {
+        lines.push("No tasks found.");
+        return lines.join("\n");
+    }
+    for (const task of items) {
+        const statusIcon = getTaskStatusIcon(task.status);
+        const priorityBadge = getPriorityBadge(task.priority);
+        lines.push(`${statusIcon} ${task.title} ${priorityBadge}`);
+        lines.push(`   ID: ${task.id} | Staging: ${task.stagingId}`);
+        if (task.model)
+            lines.push(`   Model: ${task.model}`);
+        lines.push("");
+    }
+    if (pagination.hasNext) {
+        lines.push(`📄 Next page: ${pagination.page + 1}`);
+    }
+    return lines.join("\n");
+}
+function formatTemplatesList(result) {
+    const lines = [];
+    const { items, pagination } = result;
+    lines.push(`📄 **Templates** (${pagination.page}/${pagination.totalPages}, total: ${pagination.totalItems})`);
+    lines.push("");
+    if (items.length === 0) {
+        lines.push("No templates found.");
+        return lines.join("\n");
+    }
+    for (const tpl of items) {
+        const builtIn = tpl.isBuiltIn ? " ⭐" : "";
+        lines.push(`📄 **${tpl.name}**${builtIn} (${tpl.id})`);
+        lines.push(`   Category: ${tpl.category} | Usage: ${tpl.usageCount} times`);
+        if (tpl.description) {
+            lines.push(`   ${tpl.description.substring(0, 80)}${tpl.description.length > 80 ? "..." : ""}`);
+        }
+        lines.push("");
+    }
+    if (pagination.hasNext) {
+        lines.push(`📄 Next page: ${pagination.page + 1}`);
+    }
+    return lines.join("\n");
+}
+function getStatusIcon(status) {
+    switch (status) {
+        case "draft": return "📝";
+        case "active": return "🔄";
+        case "completed": return "✅";
+        case "archived": return "📦";
+        case "cancelled": return "🚫";
+        default: return "•";
+    }
+}
+function getTaskStatusIcon(status) {
+    switch (status) {
+        case "pending": return "⏳";
+        case "in_progress": return "🔄";
+        case "done": return "✅";
+        case "blocked": return "🚧";
+        case "cancelled": return "🚫";
+        default: return "•";
+    }
+}
+function getPriorityBadge(priority) {
+    switch (priority) {
+        case "high": return "[HIGH]";
+        case "low": return "[low]";
+        default: return "";
+    }
+}
+/**
+ * Register navigation/pagination tools for quick browsing
+ */
+export function registerNavigateTools(server) {
+    // ============ get_plans_paginated ============
+    server.tool("get_plans_paginated", "Get plans with pagination support. Fast way to browse through plans.", {
+        status: z.enum(["draft", "active", "completed", "archived", "cancelled"]).optional()
+            .describe("Filter by status"),
+        page: z.number().int().min(1).default(1).describe("Page number (1-indexed)"),
+        pageSize: z.number().int().min(1).max(50).default(10).describe("Items per page"),
+        sortBy: z.enum(["createdAt", "updatedAt", "title"]).default("updatedAt")
+            .describe("Sort field"),
+        sortDir: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const paginatedResult = manager.getPlansWithPagination({
+                status: args.status,
+                page: args.page,
+                pageSize: args.pageSize,
+                sortBy: args.sortBy,
+                sortOrder: args.sortDir,
+            });
+            return { success: true, result: paginatedResult };
+        }, "get_plans_paginated");
+        if (result.success) {
+            const text = formatPlansList(result.data.result);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ get_tasks_paginated ============
+    server.tool("get_tasks_paginated", "Get tasks with pagination support. Fast way to browse through tasks.", {
+        status: z.enum(["pending", "in_progress", "done", "blocked", "cancelled"]).optional()
+            .describe("Filter by status"),
+        priority: z.enum(["high", "medium", "low"]).optional().describe("Filter by priority"),
+        planId: z.string().optional().describe("Filter by plan ID"),
+        stagingId: z.string().optional().describe("Filter by staging ID"),
+        page: z.number().int().min(1).default(1).describe("Page number (1-indexed)"),
+        pageSize: z.number().int().min(1).max(50).default(10).describe("Items per page"),
+        sortBy: z.enum(["createdAt", "updatedAt", "priority", "title"]).default("updatedAt")
+            .describe("Sort field"),
+        sortDir: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const paginatedResult = manager.getTasksWithPagination({
+                status: args.status,
+                priority: args.priority,
+                planId: args.planId,
+                stagingId: args.stagingId,
+                page: args.page,
+                pageSize: args.pageSize,
+                sortBy: args.sortBy,
+                sortOrder: args.sortDir,
+            });
+            return { success: true, result: paginatedResult };
+        }, "get_tasks_paginated");
+        if (result.success) {
+            const text = formatTasksList(result.data.result);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ get_templates_paginated ============
+    server.tool("get_templates_paginated", "Get templates with pagination support. Fast way to browse through templates.", {
+        category: z.enum(["feature", "bugfix", "refactoring", "review", "deployment", "testing", "custom"])
+            .optional().describe("Filter by category"),
+        page: z.number().int().min(1).default(1).describe("Page number (1-indexed)"),
+        pageSize: z.number().int().min(1).max(50).default(10).describe("Items per page"),
+        sortBy: z.enum(["createdAt", "updatedAt", "name", "usageCount"]).default("usageCount")
+            .describe("Sort field"),
+        sortDir: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const paginatedResult = manager.getTemplatesWithPagination({
+                category: args.category,
+                page: args.page,
+                pageSize: args.pageSize,
+                sortBy: args.sortBy,
+                sortOrder: args.sortDir,
+            });
+            return { success: true, result: paginatedResult };
+        }, "get_templates_paginated");
+        if (result.success) {
+            const text = formatTemplatesList(result.data.result);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ quick_tasks ============
+    server.tool("quick_tasks", "Quickly list tasks by common filters without pagination.", {
+        filter: z.enum(["pending", "in_progress", "blocked", "high_priority", "recent"])
+            .describe("Quick filter preset"),
+        limit: z.number().int().min(1).max(50).default(10).describe("Maximum items to return"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            let options = {
+                page: 1,
+                pageSize: args.limit,
+                sortBy: "updatedAt",
+                sortDir: "desc",
+            };
+            switch (args.filter) {
+                case "pending":
+                    options.status = "pending";
+                    break;
+                case "in_progress":
+                    options.status = "in_progress";
+                    break;
+                case "blocked":
+                    options.status = "blocked";
+                    break;
+                case "high_priority":
+                    options.priority = "high";
+                    break;
+                case "recent":
+                    // Default sort by updatedAt desc
+                    break;
+            }
+            const paginatedResult = manager.getTasksWithPagination(options);
+            return { success: true, result: paginatedResult, filter: args.filter };
+        }, "quick_tasks");
+        if (result.success) {
+            const lines = [];
+            lines.push(`⚡ **Quick Tasks: ${result.data.filter}**`);
+            lines.push("");
+            const items = result.data.result.items;
+            if (items.length === 0) {
+                lines.push("No tasks found.");
+            }
+            else {
+                for (const task of items) {
+                    const statusIcon = getTaskStatusIcon(task.status);
+                    lines.push(`${statusIcon} ${task.title} (${task.id})`);
+                }
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ quick_plans ============
+    server.tool("quick_plans", "Quickly list plans by common filters without pagination.", {
+        filter: z.enum(["active", "draft", "completed", "recent"])
+            .describe("Quick filter preset"),
+        limit: z.number().int().min(1).max(20).default(5).describe("Maximum items to return"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            let options = {
+                page: 1,
+                pageSize: args.limit,
+                sortBy: "updatedAt",
+                sortDir: "desc",
+            };
+            switch (args.filter) {
+                case "active":
+                    options.status = "active";
+                    break;
+                case "draft":
+                    options.status = "draft";
+                    break;
+                case "completed":
+                    options.status = "completed";
+                    break;
+                case "recent":
+                    // Default sort by updatedAt desc
+                    break;
+            }
+            const paginatedResult = manager.getPlansWithPagination(options);
+            return { success: true, result: paginatedResult, filter: args.filter };
+        }, "quick_plans");
+        if (result.success) {
+            const lines = [];
+            lines.push(`⚡ **Quick Plans: ${result.data.filter}**`);
+            lines.push("");
+            const items = result.data.result.items;
+            if (items.length === 0) {
+                lines.push("No plans found.");
+            }
+            else {
+                for (const plan of items) {
+                    const statusIcon = getStatusIcon(plan.status);
+                    lines.push(`${statusIcon} ${plan.title} (${plan.id})`);
+                }
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=navigate.js.map

package/dist/tools/navigate.js.map

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

package/dist/tools/rollback.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register rollback/snapshot-related tools
+ */
+export declare function registerRollbackTools(server: McpServer): void;
+//# sourceMappingURL=rollback.d.ts.map

package/dist/tools/rollback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback.d.ts","sourceRoot":"","sources":["../../src/tools/rollback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoFpE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwQ7D"}

package/dist/tools/rollback.js

@@ -0,0 +1,278 @@
+import { z } from "zod";
+import { StateManager } from "../state/manager.js";
+import { withErrorHandling, ProjectNotInitializedError, ValidationError, } from "../errors/index.js";
+// ============ Human-Readable Formatters ============
+function formatSnapshot(snapshot) {
+    const lines = [];
+    lines.push(`📸 **${snapshot.name}** (${snapshot.id})`);
+    lines.push(`   Type: ${snapshot.type} | Trigger: ${snapshot.trigger}`);
+    if (snapshot.description)
+        lines.push(`   ${snapshot.description}`);
+    const dataInfo = [];
+    if (snapshot.data.plans)
+        dataInfo.push(`${snapshot.data.plans.length} plans`);
+    if (snapshot.data.stagings)
+        dataInfo.push(`${snapshot.data.stagings.length} stagings`);
+    if (snapshot.data.tasks)
+        dataInfo.push(`${snapshot.data.tasks.length} tasks`);
+    if (snapshot.data.memories)
+        dataInfo.push(`${snapshot.data.memories.length} memories`);
+    if (snapshot.data.templates)
+        dataInfo.push(`${snapshot.data.templates.length} templates`);
+    lines.push(`   Contains: ${dataInfo.join(", ") || "empty"}`);
+    lines.push(`   Created: ${new Date(snapshot.createdAt).toLocaleString()}`);
+    if (snapshot.expiresAt) {
+        lines.push(`   Expires: ${new Date(snapshot.expiresAt).toLocaleString()}`);
+    }
+    return lines.join("\n");
+}
+function formatSnapshotList(snapshots) {
+    if (snapshots.length === 0) {
+        return "No snapshots found.";
+    }
+    const lines = [];
+    lines.push(`📸 **Snapshots** (${snapshots.length})`);
+    lines.push("");
+    // Group by type
+    const byType = new Map();
+    for (const s of snapshots) {
+        const list = byType.get(s.type) || [];
+        list.push(s);
+        byType.set(s.type, list);
+    }
+    for (const [type, snaps] of byType) {
+        lines.push(`**${type.charAt(0).toUpperCase() + type.slice(1)}:**`);
+        for (const s of snaps) {
+            const expired = s.expiresAt && new Date(s.expiresAt) < new Date() ? " ⚠️ expired" : "";
+            lines.push(`   • ${s.name}${expired} (${s.id})`);
+            lines.push(`     ${new Date(s.createdAt).toLocaleString()} | ${s.trigger}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatRestoreResult(snapshotId, restoredItems, backupSnapshotId) {
+    const lines = [];
+    lines.push(`✅ **Snapshot Restored Successfully**`);
+    lines.push(`   Snapshot: ${snapshotId}`);
+    lines.push("");
+    lines.push("**Restored:**");
+    for (const [key, count] of Object.entries(restoredItems)) {
+        if (count > 0) {
+            lines.push(`   • ${key}: ${count}`);
+        }
+    }
+    if (backupSnapshotId) {
+        lines.push("");
+        lines.push(`⚠️ Backup created: ${backupSnapshotId}`);
+    }
+    return lines.join("\n");
+}
+/**
+ * Register rollback/snapshot-related tools
+ */
+export function registerRollbackTools(server) {
+    // ============ create_snapshot ============
+    server.tool("create_snapshot", "Create a snapshot of current state for backup/rollback purposes.", {
+        name: z.string().min(1).describe("Snapshot name"),
+        description: z.string().optional().describe("Description of why this snapshot was created"),
+        type: z.enum(["full", "plan", "staging"]).default("full").describe("Snapshot type: full (all state), plan (single plan), or staging"),
+        trigger: z.enum(["manual", "auto", "pre_operation"]).default("manual").describe("What triggered this snapshot"),
+        planId: z.string().optional().describe("Plan ID (required for plan/staging type)"),
+        stagingId: z.string().optional().describe("Staging ID (required for staging type)"),
+        expiresInDays: z.number().int().min(1).max(365).optional().describe("Expiration in days (optional, default: no expiration)"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            // Validate type-specific requirements
+            if ((args.type === "plan" || args.type === "staging") && !args.planId) {
+                throw new ValidationError(`planId is required for ${args.type} snapshot type`);
+            }
+            if (args.type === "staging" && !args.stagingId) {
+                throw new ValidationError("stagingId is required for staging snapshot type");
+            }
+            // Calculate expiration date if provided
+            let expiresAt;
+            if (args.expiresInDays) {
+                const expDate = new Date();
+                expDate.setDate(expDate.getDate() + args.expiresInDays);
+                expiresAt = expDate.toISOString();
+            }
+            const snapshot = await manager.createSnapshot({
+                name: args.name,
+                description: args.description,
+                type: args.type,
+                trigger: args.trigger,
+                planId: args.planId,
+                stagingId: args.stagingId,
+                expiresAt,
+            });
+            return { success: true, snapshot };
+        }, "create_snapshot");
+        if (result.success) {
+            const text = `✅ **Snapshot Created**\n${formatSnapshot(result.data.snapshot)}`;
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ list_snapshots ============
+    server.tool("list_snapshots", "List all snapshots, optionally filtered by type or plan.", {
+        type: z.enum(["full", "plan", "staging"]).optional().describe("Filter by snapshot type"),
+        planId: z.string().optional().describe("Filter by plan ID"),
+        includeExpired: z.boolean().default(false).describe("Include expired snapshots"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            let snapshots = manager.listSnapshots({
+                type: args.type,
+                planId: args.planId,
+            });
+            // Filter expired snapshots if not included
+            if (!args.includeExpired) {
+                const now = new Date();
+                snapshots = snapshots.filter(s => !s.expiresAt || new Date(s.expiresAt) >= now);
+            }
+            return { success: true, snapshots, count: snapshots.length };
+        }, "list_snapshots");
+        if (result.success) {
+            const text = formatSnapshotList(result.data.snapshots);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ get_snapshot ============
+    server.tool("get_snapshot", "Get detailed information about a specific snapshot.", {
+        snapshotId: z.string().describe("Snapshot ID to retrieve"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const snapshot = manager.getSnapshot(args.snapshotId);
+            if (!snapshot) {
+                throw new ValidationError(`Snapshot not found: ${args.snapshotId}`);
+            }
+            return { success: true, snapshot };
+        }, "get_snapshot");
+        if (result.success) {
+            const text = formatSnapshot(result.data.snapshot);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ restore_snapshot ============
+    server.tool("restore_snapshot", "Restore state from a snapshot. Creates a backup before restoring by default.", {
+        snapshotId: z.string().describe("Snapshot ID to restore from"),
+        createBackup: z.boolean().default(true).describe("Create a backup snapshot before restoring"),
+        restorePlans: z.boolean().default(true).describe("Restore plans"),
+        restoreStagings: z.boolean().default(true).describe("Restore stagings"),
+        restoreTasks: z.boolean().default(true).describe("Restore tasks"),
+        restoreMemories: z.boolean().default(false).describe("Restore memories"),
+        restoreTemplates: z.boolean().default(false).describe("Restore templates"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const restoreResult = await manager.restoreSnapshot(args.snapshotId, {
+                createBackup: args.createBackup,
+                restorePlans: args.restorePlans,
+                restoreStagings: args.restoreStagings,
+                restoreTasks: args.restoreTasks,
+                restoreMemories: args.restoreMemories,
+                restoreTemplates: args.restoreTemplates,
+            });
+            return {
+                success: true,
+                snapshotId: args.snapshotId,
+                ...restoreResult,
+            };
+        }, "restore_snapshot");
+        if (result.success) {
+            const text = formatRestoreResult(result.data.snapshotId, result.data.restoredItems, result.data.backupSnapshotId);
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ delete_snapshot ============
+    server.tool("delete_snapshot", "Delete a snapshot permanently.", {
+        snapshotId: z.string().describe("Snapshot ID to delete"),
+    }, async (args) => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const snapshot = manager.getSnapshot(args.snapshotId);
+            if (!snapshot) {
+                throw new ValidationError(`Snapshot not found: ${args.snapshotId}`);
+            }
+            const snapshotName = snapshot.name;
+            await manager.deleteSnapshot(args.snapshotId);
+            return { success: true, snapshotName, snapshotId: args.snapshotId };
+        }, "delete_snapshot");
+        if (result.success) {
+            const text = `🗑️ **Snapshot Deleted**: ${result.data.snapshotName}\n   ID: ${result.data.snapshotId}`;
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============ cleanup_snapshots ============
+    server.tool("cleanup_snapshots", "Clean up expired snapshots. Returns count of deleted snapshots.", {}, async () => {
+        const result = await withErrorHandling(async () => {
+            const manager = StateManager.getInstance();
+            if (!manager.isInitialized()) {
+                throw new ProjectNotInitializedError();
+            }
+            const deletedCount = await manager.cleanupExpiredSnapshots();
+            return { success: true, deletedCount };
+        }, "cleanup_snapshots");
+        if (result.success) {
+            const count = result.data.deletedCount;
+            const text = count > 0
+                ? `🧹 **Cleaned Up ${count} Expired Snapshot(s)**`
+                : "No expired snapshots to clean up.";
+            return { content: [{ type: "text", text }] };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `❌ ${result.error.message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=rollback.js.map