quicklify 1.0.5 → 1.2.0

package/dist/mcp/tools/serverInfo.js

@@ -0,0 +1,283 @@
+import { z } from "zod";
+import { getServers, findServer } from "../../utils/config.js";
+import { checkCoolifyHealth, checkServerStatus, checkAllServersStatus } from "../../core/status.js";
+import { getProviderToken, collectProviderTokensFromEnv } from "../../core/tokens.js";
+import { getErrorMessage } from "../../utils/errorMapper.js";
+import { isBareServer } from "../../utils/modeGuard.js";
+import { sshExec } from "../../utils/ssh.js";
+import { createProviderWithToken } from "../../utils/providerFactory.js";
+import { mcpSuccess, mcpError } from "../utils.js";
+export const serverInfoSchema = {
+    action: z.enum(["list", "status", "health", "sizes"]).describe("Action to perform: 'list' all servers, 'status' check server/cloud status, 'health' check Coolify reachability (or SSH reachability for bare servers), 'sizes' list available server types with prices for a provider+region"),
+    server: z.string().optional().describe("Server name or IP. Required for single-server status/health. Omit for all servers."),
+    provider: z.enum(["hetzner", "digitalocean", "vultr", "linode"]).optional().describe("Cloud provider (required for 'sizes' action)"),
+    region: z.string().optional().describe("Region/location ID (required for 'sizes' action, e.g. 'nbg1' for Hetzner, 'fra1' for DigitalOcean)"),
+    mode: z.enum(["coolify", "bare"]).optional().describe("Server mode filter for 'sizes' action. Coolify requires min 2GB RAM. Default: coolify"),
+};
+function formatServerList(servers) {
+    if (servers.length === 0) {
+        return {
+            servers: [],
+            total: 0,
+            message: "No servers found. Deploy one with: quicklify init",
+            suggested_actions: [
+                { command: "quicklify init", reason: "Deploy your first Coolify server" },
+            ],
+        };
+    }
+    return {
+        servers: servers.map((s) => ({
+            name: s.name,
+            ip: s.ip,
+            provider: s.provider,
+            region: s.region,
+            size: s.size,
+            id: s.id,
+            mode: s.mode ?? "coolify",
+            createdAt: s.createdAt,
+        })),
+        total: servers.length,
+        suggested_actions: [
+            { command: "server_info { action: 'status' }", reason: "Check status of all servers" },
+            { command: "server_info { action: 'health' }", reason: "Check health on all servers" },
+        ],
+    };
+}
+function formatStatusResult(result) {
+    return {
+        name: result.server.name,
+        ip: result.server.ip,
+        provider: result.server.provider,
+        region: result.server.region,
+        size: result.server.size,
+        mode: result.server.mode ?? "coolify",
+        serverStatus: result.serverStatus,
+        coolifyStatus: result.coolifyStatus,
+        ...(result.error ? { error: result.error } : {}),
+    };
+}
+function formatStatusResults(results) {
+    const suggestedActions = [];
+    const notReachable = results.filter((r) => r.coolifyStatus === "not reachable");
+    if (notReachable.length > 0) {
+        for (const r of notReachable) {
+            suggestedActions.push({
+                command: `quicklify status ${r.server.name} --autostart`,
+                reason: `Coolify is not reachable on ${r.server.name}, try auto-restart`,
+            });
+        }
+    }
+    const errors = results.filter((r) => r.error);
+    if (errors.length > 0) {
+        suggestedActions.push({
+            command: "quicklify doctor --check-tokens",
+            reason: "API errors detected, verify provider tokens",
+        });
+    }
+    if (suggestedActions.length === 0) {
+        suggestedActions.push({
+            command: "server_logs { action: 'logs' }",
+            reason: "All servers healthy, check logs for details",
+        });
+    }
+    return {
+        results: results.map(formatStatusResult),
+        summary: {
+            total: results.length,
+            running: results.filter((r) => r.coolifyStatus === "running").length,
+            notReachable: notReachable.length,
+            errors: errors.length,
+        },
+        suggested_actions: suggestedActions,
+    };
+}
+async function checkBareServerSsh(server) {
+    try {
+        const result = await sshExec(server.ip, "echo ok");
+        return result.code === 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function handleServerInfo(params) {
+    try {
+        switch (params.action) {
+            case "list": {
+                const servers = getServers();
+                return mcpSuccess(formatServerList(servers));
+            }
+            case "status": {
+                const servers = getServers();
+                if (servers.length === 0) {
+                    return mcpError("No servers found", undefined, [{ command: "quicklify init", reason: "Deploy a server first" }]);
+                }
+                if (params.server) {
+                    const server = findServer(params.server);
+                    if (!server) {
+                        return {
+                            content: [{ type: "text", text: JSON.stringify({
+                                        error: `Server not found: ${params.server}`,
+                                        available_servers: servers.map((s) => s.name),
+                                    }) }],
+                            isError: true,
+                        };
+                    }
+                    const token = server.id.startsWith("manual-") ? "" : (getProviderToken(server.provider) ?? "");
+                    if (!token && !server.id.startsWith("manual-")) {
+                        return {
+                            content: [{ type: "text", text: JSON.stringify({
+                                        error: `No API token found for provider: ${server.provider}`,
+                                        hint: `Set environment variable: ${server.provider.toUpperCase()}_TOKEN`,
+                                        server: { name: server.name, ip: server.ip, provider: server.provider },
+                                    }) }],
+                            isError: true,
+                        };
+                    }
+                    const result = await checkServerStatus(server, token);
+                    return mcpSuccess(formatStatusResults([result]));
+                }
+                // All servers
+                const tokenMap = collectProviderTokensFromEnv(servers);
+                const missingTokenProviders = [
+                    ...new Set(servers.filter((s) => !s.id.startsWith("manual-")).map((s) => s.provider)),
+                ].filter((p) => !tokenMap.has(p));
+                if (missingTokenProviders.length > 0) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    error: "Missing API tokens for providers",
+                                    missing: missingTokenProviders.map((p) => ({
+                                        provider: p,
+                                        envVar: `${p.toUpperCase()}_TOKEN`,
+                                    })),
+                                    hint: "Set environment variables for each provider",
+                                }) }],
+                        isError: true,
+                    };
+                }
+                const results = await checkAllServersStatus(servers, tokenMap);
+                return mcpSuccess(formatStatusResults(results));
+            }
+            case "health": {
+                const servers = getServers();
+                if (servers.length === 0) {
+                    return mcpError("No servers found", undefined, [{ command: "quicklify init", reason: "Deploy a server first" }]);
+                }
+                if (params.server) {
+                    const server = findServer(params.server);
+                    if (!server) {
+                        return {
+                            content: [{ type: "text", text: JSON.stringify({
+                                        error: `Server not found: ${params.server}`,
+                                        available_servers: servers.map((s) => s.name),
+                                    }) }],
+                            isError: true,
+                        };
+                    }
+                    // Bare server: check SSH reachability
+                    if (isBareServer(server)) {
+                        const sshReachable = await checkBareServerSsh(server);
+                        const suggestedActions = sshReachable
+                            ? [{ command: `ssh root@${server.ip}`, reason: "Connect to your bare server" }]
+                            : [{ command: `quicklify status ${server.name}`, reason: "Check server cloud status" }];
+                        return mcpSuccess({
+                            server: server.name,
+                            ip: server.ip,
+                            mode: "bare",
+                            sshReachable,
+                            suggested_actions: suggestedActions,
+                        });
+                    }
+                    // Coolify server: check Coolify health
+                    const status = await checkCoolifyHealth(server.ip);
+                    const suggestedActions = status === "not reachable"
+                        ? [{ command: `quicklify status ${server.name} --autostart`, reason: "Try auto-restart Coolify" }]
+                        : [{ command: `http://${server.ip}:8000`, reason: "Access Coolify dashboard" }];
+                    return mcpSuccess({
+                        server: server.name,
+                        ip: server.ip,
+                        coolifyStatus: status,
+                        coolifyUrl: status === "running" ? `http://${server.ip}:8000` : null,
+                        suggested_actions: suggestedActions,
+                    });
+                }
+                // All servers health — route based on mode
+                const healthResults = await Promise.all(servers.map(async (s) => {
+                    if (isBareServer(s)) {
+                        const sshReachable = await checkBareServerSsh(s);
+                        return {
+                            name: s.name,
+                            ip: s.ip,
+                            mode: "bare",
+                            sshReachable,
+                        };
+                    }
+                    return {
+                        name: s.name,
+                        ip: s.ip,
+                        mode: "coolify",
+                        coolifyStatus: await checkCoolifyHealth(s.ip),
+                    };
+                }));
+                const coolifyResults = healthResults.filter((r) => r.mode === "coolify");
+                const bareResults = healthResults.filter((r) => r.mode === "bare");
+                const notReachableCoolify = coolifyResults.filter((r) => "coolifyStatus" in r && r.coolifyStatus === "not reachable");
+                const suggestedActions = notReachableCoolify.length > 0
+                    ? notReachableCoolify.map((r) => ({
+                        command: `quicklify status ${r.name} --autostart`,
+                        reason: `Coolify not reachable on ${r.name}`,
+                    }))
+                    : [{ command: "server_info { action: 'status' }", reason: "All healthy, check full status" }];
+                return mcpSuccess({
+                    results: healthResults,
+                    summary: {
+                        total: healthResults.length,
+                        running: coolifyResults.filter((r) => "coolifyStatus" in r && r.coolifyStatus === "running").length,
+                        notReachable: notReachableCoolify.length,
+                        bare: bareResults.length,
+                    },
+                    suggested_actions: suggestedActions,
+                });
+            }
+            case "sizes": {
+                if (!params.provider) {
+                    return mcpError("Provider is required for 'sizes' action", "Specify provider: 'hetzner', 'digitalocean', 'vultr', or 'linode'");
+                }
+                if (!params.region) {
+                    return mcpError("Region is required for 'sizes' action", "Specify region (e.g. 'nbg1' for Hetzner, 'fra1' for DigitalOcean, 'ewr' for Vultr, 'us-east' for Linode)");
+                }
+                const token = getProviderToken(params.provider);
+                if (!token) {
+                    return mcpError(`No API token found for provider: ${params.provider}`, `Set environment variable: ${params.provider.toUpperCase()}_TOKEN`);
+                }
+                const provider = createProviderWithToken(params.provider, token);
+                const mode = params.mode ?? "coolify";
+                const sizes = await provider.getAvailableServerTypes(params.region, mode);
+                return mcpSuccess({
+                    provider: params.provider,
+                    region: params.region,
+                    mode,
+                    sizes: sizes.map((s) => ({
+                        id: s.id,
+                        name: s.name,
+                        vcpu: s.vcpu,
+                        ram: `${s.ram}GB`,
+                        disk: `${s.disk}GB`,
+                        price: s.price,
+                    })),
+                    total: sizes.length,
+                    suggested_actions: [
+                        {
+                            command: `server_provision { provider: '${params.provider}', name: 'my-server', region: '${params.region}', size: '${sizes[0]?.id ?? "..."}', mode: '${mode}' }`,
+                            reason: "Provision a server with one of these sizes",
+                        },
+                    ],
+                });
+            }
+        }
+    }
+    catch (error) {
+        return mcpError(getErrorMessage(error));
+    }
+}
+//# sourceMappingURL=serverInfo.js.map

package/dist/mcp/tools/serverInfo.js.map

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

package/dist/mcp/tools/serverLogs.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { type McpResponse } from "../utils.js";
+import type { LogService } from "../../core/logs.js";
+export declare const serverLogsSchema: {
+    action: z.ZodEnum<{
+        logs: "logs";
+        monitor: "monitor";
+    }>;
+    server: z.ZodOptional<z.ZodString>;
+    service: z.ZodDefault<z.ZodEnum<{
+        coolify: "coolify";
+        docker: "docker";
+        system: "system";
+    }>>;
+    lines: z.ZodDefault<z.ZodNumber>;
+    containers: z.ZodDefault<z.ZodBoolean>;
+};
+export declare function handleServerLogs(params: {
+    action: "logs" | "monitor";
+    server?: string;
+    service?: LogService;
+    lines?: number;
+    containers?: boolean;
+}): Promise<McpResponse>;
+//# sourceMappingURL=serverLogs.d.ts.map

package/dist/mcp/tools/serverLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverLogs.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/serverLogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAgB5B,CAAC;AAOF,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CAiIvB"}

package/dist/mcp/tools/serverLogs.js

@@ -0,0 +1,124 @@
+import { z } from "zod";
+import { getServers } from "../../utils/config.js";
+import { fetchServerLogs, fetchServerMetrics } from "../../core/logs.js";
+import { isBareServer } from "../../utils/modeGuard.js";
+import { resolveServerForMcp, mcpSuccess, mcpError, } from "../utils.js";
+import { getErrorMessage } from "../../utils/errorMapper.js";
+export const serverLogsSchema = {
+    action: z.enum(["logs", "monitor"]).describe("Action: 'logs' fetch recent log lines, 'monitor' fetch CPU/RAM/Disk metrics"),
+    server: z.string().optional().describe("Server name or IP. Auto-selected if only one server exists."),
+    service: z.enum(["coolify", "docker", "system"]).default("coolify").describe("Log source (only for 'logs' action): 'coolify' container (Coolify servers only), 'docker' service journal, 'system' full journal"),
+    lines: z.number().min(1).max(500).default(50).describe("Number of log lines to fetch (only for 'logs' action, default: 50, max: 500)"),
+    containers: z.boolean().default(false).describe("Include Docker container list in metrics (only for 'monitor' action)"),
+};
+export async function handleServerLogs(params) {
+    try {
+        const servers = getServers();
+        if (servers.length === 0) {
+            return mcpError("No servers found", undefined, [
+                { command: "quicklify init", reason: "Deploy a server first" },
+            ]);
+        }
+        const server = resolveServerForMcp(params, servers);
+        if (!server) {
+            if (params.server) {
+                return mcpError(`Server not found: ${params.server}`, `Available servers: ${servers.map((s) => s.name).join(", ")}`);
+            }
+            return mcpError("Multiple servers found. Specify which server to use.", `Available: ${servers.map((s) => s.name).join(", ")}`);
+        }
+        switch (params.action) {
+            case "logs": {
+                const service = params.service ?? "coolify";
+                const lines = params.lines ?? 50;
+                // Guard: bare servers cannot read coolify service logs
+                if (isBareServer(server) && service === "coolify") {
+                    return mcpError("Coolify logs not available on bare servers", "Use service: 'system' or 'docker' for bare servers", [
+                        {
+                            command: `server_logs { action: 'logs', server: '${server.name}', service: 'system' }`,
+                            reason: "View system journal instead",
+                        },
+                    ]);
+                }
+                const result = await fetchServerLogs(server.ip, service, lines);
+                if (result.error) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    server: server.name,
+                                    ip: server.ip,
+                                    service,
+                                    error: result.error,
+                                    ...(result.hint ? { hint: result.hint } : {}),
+                                    ...(result.logs ? { partial_logs: result.logs } : {}),
+                                    suggested_actions: [
+                                        { command: `quicklify logs ${server.name} --service ${service}`, reason: "Try from CLI for interactive mode" },
+                                        { command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Check if server is reachable" },
+                                    ],
+                                }) }],
+                        isError: true,
+                    };
+                }
+                const suggestedActions = [
+                    { command: `server_logs { action: 'monitor', server: '${server.name}' }`, reason: "Check system metrics" },
+                ];
+                if (lines < 200) {
+                    suggestedActions.unshift({
+                        command: `server_logs { action: 'logs', server: '${server.name}', service: '${service}', lines: 200 }`,
+                        reason: "Fetch more lines",
+                    });
+                }
+                if (service === "coolify") {
+                    suggestedActions.push({
+                        command: `server_logs { action: 'logs', server: '${server.name}', service: 'system' }`,
+                        reason: "Check system journal",
+                    });
+                }
+                return mcpSuccess({
+                    server: server.name,
+                    ip: server.ip,
+                    service,
+                    lines,
+                    logs: result.logs,
+                    suggested_actions: suggestedActions,
+                });
+            }
+            case "monitor": {
+                const includeContainers = isBareServer(server) ? false : (params.containers ?? false);
+                const result = await fetchServerMetrics(server.ip, includeContainers);
+                if (result.error) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    server: server.name,
+                                    ip: server.ip,
+                                    error: result.error,
+                                    ...(result.hint ? { hint: result.hint } : {}),
+                                    suggested_actions: [
+                                        { command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Check if server is reachable" },
+                                    ],
+                                }) }],
+                        isError: true,
+                    };
+                }
+                const suggestedActions = [
+                    { command: `server_logs { action: 'logs', server: '${server.name}' }`, reason: "Check recent logs" },
+                ];
+                if (!includeContainers) {
+                    suggestedActions.unshift({
+                        command: `server_logs { action: 'monitor', server: '${server.name}', containers: true }`,
+                        reason: "Include Docker container list",
+                    });
+                }
+                return mcpSuccess({
+                    server: server.name,
+                    ip: server.ip,
+                    metrics: result.metrics,
+                    ...(result.containers ? { containers: result.containers } : {}),
+                    suggested_actions: suggestedActions,
+                });
+            }
+        }
+    }
+    catch (error) {
+        return mcpError(getErrorMessage(error));
+    }
+}
+//# sourceMappingURL=serverLogs.js.map

package/dist/mcp/tools/serverLogs.js.map

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

package/dist/mcp/tools/serverMaintain.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { type McpResponse } from "../utils.js";
+export declare const serverMaintainSchema: {
+    action: z.ZodEnum<{
+        restart: "restart";
+        update: "update";
+        maintain: "maintain";
+    }>;
+    server: z.ZodOptional<z.ZodString>;
+    skipReboot: z.ZodDefault<z.ZodBoolean>;
+};
+export declare function handleServerMaintain(params: {
+    action: "update" | "restart" | "maintain";
+    server?: string;
+    skipReboot?: boolean;
+}): Promise<McpResponse>;
+//# sourceMappingURL=serverMaintain.d.ts.map

package/dist/mcp/tools/serverMaintain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverMaintain.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/serverMaintain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,oBAAoB;;;;;;;;CAUhC,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4LvB"}

package/dist/mcp/tools/serverMaintain.js

@@ -0,0 +1,156 @@
+import { z } from "zod";
+import { getServers } from "../../utils/config.js";
+import { getProviderToken } from "../../core/tokens.js";
+import { isSafeMode } from "../../core/manage.js";
+import { executeCoolifyUpdate, rebootAndWait, maintainServer, } from "../../core/maintain.js";
+import { requireCoolifyMode } from "../../utils/modeGuard.js";
+import { resolveServerForMcp, mcpSuccess, mcpError, } from "../utils.js";
+import { getErrorMessage } from "../../utils/errorMapper.js";
+export const serverMaintainSchema = {
+    action: z.enum(["update", "restart", "maintain"]).describe("Action: 'update' runs Coolify update via SSH (Coolify servers only), 'restart' reboots server via cloud provider API (both modes), 'maintain' runs full 5-step maintenance (status → update → health → reboot → final, Coolify servers only)"),
+    server: z.string().optional().describe("Server name or IP. Auto-selected if only one server exists."),
+    skipReboot: z.boolean().default(false).describe("Skip reboot and final check steps (only for 'maintain' action). Useful during business hours."),
+};
+export async function handleServerMaintain(params) {
+    try {
+        const servers = getServers();
+        if (servers.length === 0) {
+            return mcpError("No servers found", undefined, [
+                { command: "quicklify init", reason: "Deploy a server first" },
+            ]);
+        }
+        const server = resolveServerForMcp(params, servers);
+        if (!server) {
+            if (params.server) {
+                return mcpError(`Server not found: ${params.server}`, `Available servers: ${servers.map((s) => s.name).join(", ")}`);
+            }
+            return mcpError("Multiple servers found. Specify which server to use.", `Available: ${servers.map((s) => s.name).join(", ")}`);
+        }
+        switch (params.action) {
+            case "update": {
+                // Guard: update requires Coolify
+                const modeError = requireCoolifyMode(server, "update");
+                if (modeError) {
+                    return mcpError(modeError, "Use SSH to manage bare servers directly");
+                }
+                const result = await executeCoolifyUpdate(server.ip);
+                if (!result.success) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    server: server.name,
+                                    ip: server.ip,
+                                    error: result.error,
+                                    ...(result.hint ? { hint: result.hint } : {}),
+                                    suggested_actions: [
+                                        { command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Check if server is reachable" },
+                                    ],
+                                }) }],
+                        isError: true,
+                    };
+                }
+                return mcpSuccess({
+                    success: true,
+                    server: server.name,
+                    ip: server.ip,
+                    message: "Coolify update completed successfully",
+                    suggested_actions: [
+                        { command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Verify Coolify is running after update" },
+                        { command: `server_logs { action: 'logs', server: '${server.name}' }`, reason: "Check logs after update" },
+                    ],
+                });
+            }
+            case "restart": {
+                if (isSafeMode()) {
+                    return mcpError("Restart is disabled in SAFE_MODE", "Set QUICKLIFY_SAFE_MODE=false to enable server reboot", [{ command: `server_maintain { action: 'update', server: '${server.name}' }`, reason: "Run Coolify update instead (non-destructive)" }]);
+                }
+                // Restart requires API token for cloud provider — no mode guard (works on both)
+                const isManual = server.id.startsWith("manual-");
+                if (isManual) {
+                    return mcpError("Cannot reboot manually added server via API", `Use SSH: ssh root@${server.ip} reboot`);
+                }
+                const token = getProviderToken(server.provider);
+                if (!token) {
+                    return mcpError(`No API token found for provider: ${server.provider}`, `Set environment variable: ${server.provider.toUpperCase()}_TOKEN`);
+                }
+                const result = await rebootAndWait(server, token);
+                if (!result.success) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({
+                                    server: server.name,
+                                    ip: server.ip,
+                                    error: result.error,
+                                    ...(result.hint ? { hint: result.hint } : {}),
+                                    suggested_actions: [
+                                        { command: `server_info { action: 'status', server: '${server.name}' }`, reason: "Check current server status" },
+                                    ],
+                                }) }],
+                        isError: true,
+                    };
+                }
+                return mcpSuccess({
+                    success: true,
+                    server: server.name,
+                    ip: server.ip,
+                    message: "Server restarted successfully",
+                    finalStatus: result.finalStatus,
+                    suggested_actions: [
+                        { command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Verify Coolify is accessible" },
+                        { command: `server_logs { action: 'logs', server: '${server.name}' }`, reason: "Check logs after restart" },
+                    ],
+                });
+            }
+            case "maintain": {
+                // Guard: maintain requires Coolify
+                const modeError = requireCoolifyMode(server, "maintain");
+                if (modeError) {
+                    return mcpError(modeError, "Use SSH to manage bare servers directly");
+                }
+                if (isSafeMode()) {
+                    return mcpError("Maintenance is disabled in SAFE_MODE", "Set QUICKLIFY_SAFE_MODE=false to enable full maintenance (includes reboot)", [{ command: `server_maintain { action: 'update', server: '${server.name}' }`, reason: "Run Coolify update only (non-destructive)" }]);
+                }
+                // Maintain requires API token for non-manual servers
+                const isManual = server.id.startsWith("manual-");
+                let token = "";
+                if (!isManual) {
+                    const envToken = getProviderToken(server.provider);
+                    if (!envToken) {
+                        return mcpError(`No API token found for provider: ${server.provider}`, `Set environment variable: ${server.provider.toUpperCase()}_TOKEN`, [{ command: `server_maintain { action: 'update', server: '${server.name}' }`, reason: "Run update only (no token needed)" }]);
+                    }
+                    token = envToken;
+                }
+                const result = await maintainServer(server, token, {
+                    skipReboot: params.skipReboot ?? false,
+                });
+                const suggestedActions = [];
+                const hasFailure = result.steps.some((s) => s.status === "failure");
+                if (hasFailure) {
+                    suggestedActions.push({ command: `server_info { action: 'health', server: '${server.name}' }`, reason: "Check Coolify reachability" }, { command: `server_logs { action: 'logs', server: '${server.name}' }`, reason: "Check logs for errors" });
+                }
+                else {
+                    suggestedActions.push({ command: `server_info { action: 'status', server: '${server.name}' }`, reason: "Verify full server status" }, { command: `server_logs { action: 'logs', server: '${server.name}' }`, reason: "Check Coolify startup logs" });
+                }
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                success: result.success,
+                                server: result.server,
+                                ip: result.ip,
+                                provider: result.provider,
+                                steps: result.steps,
+                                summary: {
+                                    total: result.steps.length,
+                                    success: result.steps.filter((s) => s.status === "success").length,
+                                    failure: result.steps.filter((s) => s.status === "failure").length,
+                                    skipped: result.steps.filter((s) => s.status === "skipped").length,
+                                },
+                                suggested_actions: suggestedActions,
+                            }) }],
+                    ...(hasFailure ? { isError: true } : {}),
+                };
+            }
+        }
+    }
+    catch (error) {
+        return mcpError(getErrorMessage(error));
+    }
+}
+//# sourceMappingURL=serverMaintain.js.map