@sashido/mcp-server 0.0.0-stage → 0.2.0

package/dist/tools/advisor/index.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { schemaChecks } from "../../advice/schemaChecks.js";
+import { formatChecks, formatUpgrade } from "../../advice/format.js";
+import { byRule, rulesFor, scanFile } from "../../upgrade/scan.js";
+import { majorsCrossed } from "../../upgrade/rules.js";
+import { compareVersions, hasAppChecks, isOutdated, versionParts } from "../../upgrade/versions.js";
+import { versionLabel } from "../infrastructure/index.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const CODE_FILE = /\.(m?js|cjs|ts)$/;
+const MAX_FILES = 80;
+const DAY_MS = 24 * 60 * 60 * 1000;
+async function appVersion(ctx, appObjectId) {
+    const app = (await ctx.sashido().listApps()).find((a) => a.objectId === appObjectId);
+    if (!app) {
+        throw new Error(`App ${appObjectId} not found.`);
+    }
+    return { name: app.name, version: app.parseServerVersion };
+}
+/** Scans the app's cloud code files with the rules: findings, files read and not */
+async function scanCloudCode(parse, rules) {
+    const files = (await parse.listCloudCodeFiles()).cloudFiles
+        .map((f) => f.path)
+        .filter((path) => CODE_FILE.test(path) && path.indexOf("node_modules/") === -1);
+    const findings = [];
+    const skipped = files.slice(MAX_FILES);
+    let scanned = 0;
+    for (const path of files.slice(0, MAX_FILES)) {
+        try {
+            findings.push(...scanFile(path, await parse.readCloudCodeFile(path), rules));
+            scanned++;
+        }
+        catch {
+            skipped.push(path);
+        }
+    }
+    return { findings, scanned, skipped };
+}
+// a part of the advice that can't be done (e.g. a scope the token lacks)
+// is said, not fatal
+async function part(lines, title, work) {
+    try {
+        lines.push(`${title}:`, ...(await work()), "");
+    }
+    catch (e) {
+        lines.push(`${title}: skipped (${e instanceof Error ? e.message : "failed"}).`, "");
+    }
+}
+export function registerAdvisorTools(server, ctx) {
+    server.tool("get_app_advice", "Check an app for what to fix: security (class-level permissions, client push, class creation, social logins), users and sessions, the database (Parse Server 6.5.11+ runs its own checks; older versions get the schema checks), its Parse Server version, health, recent errors and failed jobs. Each problem comes with what to do.", {
+        appObjectId: z.string().describe("The application object ID"),
+    }, async (args) => {
+        const { name, version } = await appVersion(ctx, args.appObjectId);
+        const parse = ctx.parse(args.appObjectId);
+        const lines = [`Advice for ${name} (Parse Server ${versionLabel(version)})`, ""];
+        if (isOutdated(version)) {
+            // what is offered now, not what is announced
+            const versions = await ctx.sashido().listParseServerVersions().catch(() => []);
+            const newest = [...versions].sort((a, b) => compareVersions(b.imageTag, a.imageTag))[0];
+            lines.push(`⚠️ Parse Server ${versionLabel(version)} is an older major version${newest ? `; ${versionLabel(newest.imageTag)} is available` : ""}, with security fixes and a current Node.js. plan_parse_server_upgrade shows what the cloud code needs.`, "");
+        }
+        await part(lines, "Security and data", async () => {
+            if (hasAppChecks(version)) {
+                const report = await parse.getAppChecks();
+                const checks = [];
+                report.groups.forEach((g) => g.checks.forEach((c) => checks.push({ ...c, group: g.name })));
+                return formatChecks(checks);
+            }
+            const checks = schemaChecks(await parse.listClasses());
+            return [
+                ...formatChecks(checks),
+                "(Parse Server 6.5.11+ also checks client push, class creation, social logins, users and sessions, and the database.)",
+            ];
+        });
+        // code written for an older major than the app runs (e.g. 2.x code on 6)
+        const major = versionParts(version)[0];
+        if (major > 0) {
+            await part(lines, "Cloud code", async () => {
+                const rules = rulesFor(0, major).filter((r) => r.severity === "breaks");
+                const { findings, scanned } = await scanCloudCode(parse, rules);
+                if (!findings.length) {
+                    return [`✓ ${scanned} file${scanned === 1 ? "" : "s"} read: nothing that stopped working by Parse Server ${major}.`];
+                }
+                const out = [];
+                for (const g of byRule(findings)) {
+                    out.push(`❗ ${g.rule.title}: stopped working in Parse Server ${g.rule.major}; this app runs ${versionLabel(version)}.`, `   What to do: ${g.rule.fix}`);
+                    out.push(...g.places.slice(0, 6).map((p) => `     ${p.file}:${p.line}  ${p.text}`));
+                    if (g.places.length > 6) {
+                        out.push(`     … and ${g.places.length - 6} more`);
+                    }
+                }
+                return out;
+            });
+        }
+        await part(lines, "Running", async () => {
+            const out = [];
+            const health = await parse.checkHealth().catch((e) => ({ status: `unreachable: ${e.message}` }));
+            out.push(health.status === "ok" ? "✓ The app server answers its health check." : `❗ Health check: ${health.status}.`);
+            if (ctx.access.scopes.indexOf("logs:read") !== -1) {
+                const errors = await parse.getLogs({ level: "error", limit: 100 });
+                const recent = errors.filter((e) => Date.now() - Date.parse(e.timestamp) < DAY_MS);
+                out.push(recent.length
+                    ? `⚠️ ${recent.length} error${recent.length === 1 ? "" : "s"} in the last 24 hours: get_error_logs shows them.`
+                    : "✓ No errors in the cloud code logs in the last 24 hours.");
+            }
+            const runs = await parse.getJobStatus(20).catch(() => []);
+            const failed = runs.filter((r) => r.status === "failed");
+            if (failed.length) {
+                out.push(`⚠️ ${failed.length} of the last ${runs.length} job runs failed: ${[...new Set(failed.map((r) => r.jobName))].join(", ")} (get_job_status).`);
+            }
+            else if (runs.length) {
+                out.push(`✓ The last ${runs.length} job runs didn't fail.`);
+            }
+            return out;
+        });
+        return text(lines.join("\n").trim());
+    });
+    server.tool("plan_parse_server_upgrade", "Plan an app's move to a newer Parse Server version (e.g. to 6 or 8): which of its cloud code breaks, where (file and line), how to change it, with sources from Parse Server's migration guides; what SashiDo handles; and the steps, with a way back. Reads the cloud code, changes nothing.", {
+        appObjectId: z.string().describe("The application object ID"),
+        imageTag: z.string().optional().describe("The target version's imageTag (list_parse_server_versions); default: the newest"),
+    }, async (args) => {
+        const { name, version } = await appVersion(ctx, args.appObjectId);
+        const versions = await ctx.sashido().listParseServerVersions();
+        const newest = [...versions].sort((a, b) => compareVersions(b.imageTag, a.imageTag))[0];
+        const target = args.imageTag ? versions.find((v) => v.imageTag === args.imageTag) : newest;
+        if (!target) {
+            return text(`❌ ${args.imageTag} isn't a version apps can use: list_parse_server_versions shows them.`);
+        }
+        if (version && compareVersions(target.imageTag, version) <= 0) {
+            return text(`${name} already runs Parse Server ${versionLabel(version)}, not older than ${versionLabel(target.imageTag)}.`);
+        }
+        const from = versionParts(version)[0];
+        const to = versionParts(target.imageTag)[0];
+        const rules = rulesFor(from, to);
+        const { findings, scanned, skipped } = await scanCloudCode(ctx.parse(args.appObjectId), rules);
+        return text(formatUpgrade({
+            app: name,
+            from: versionLabel(version),
+            to: versionLabel(target.imageTag),
+            toTag: target.imageTag,
+            majors: majorsCrossed(from, to),
+            rules,
+            findings,
+            filesScanned: scanned,
+            filesSkipped: skipped,
+            rollback: version && versions.some((v) => v.imageTag === version) ? version : null,
+        }));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/advisor/index.js.map

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

package/dist/tools/apps/index.d.ts

@@ -0,0 +1,3 @@
+import { ToolContext, ToolServer } from "../../context.js";
+export declare function registerAppTools(server: ToolServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/apps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/apps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI3D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA4I3E"}

package/dist/tools/apps/index.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { SashidoClient } from "../../client/sashido.js";
+export function registerAppTools(server, ctx) {
+    const getAuthFromRequest = (_args, _extra) => ctx.token;
+    // List Apps
+    server.tool("list_apps", "List all applications owned by the authenticated user", {}, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        const apps = await client.listApps();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(apps, null, 2),
+                },
+            ],
+        };
+    });
+    // Get App (by objectId from list_apps)
+    server.tool("get_app", "Get detailed information about a specific application by its objectId", {
+        appObjectId: z.string().describe("The application object ID"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        // Get all apps and find the one with matching objectId
+        const apps = await client.listApps();
+        const app = apps.find((a) => a.objectId === args.appObjectId);
+        if (!app) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `App with objectId ${args.appObjectId} not found`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(app, null, 2),
+                },
+            ],
+        };
+    });
+    // Create App
+    server.tool("create_app", "Create a new Parse Server application", {
+        name: z.string().describe("Application name"),
+        region: z
+            .string()
+            .describe('Region: "eu" (Europe, 1-eu), "us" (North America, 2-us), "jp" (Japan, 1-jp) or "au" (Australia, 1-au)'),
+        parseServerVersion: z
+            .string()
+            .optional()
+            .describe("The version's imageTag from list_parse_server_versions; default: the one marked as default for new apps"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        // Region mapping: short code -> full format expected by API
+        const regionMap = {
+            eu: "1-eu",
+            us: "2-us",
+            jp: "1-jp",
+            au: "1-au",
+        };
+        // Normalize region: "eu" -> "1-eu", "1-eu" -> "1-eu"
+        let region = args.region;
+        const shortCode = region.toLowerCase();
+        if (regionMap[shortCode]) {
+            region = regionMap[shortCode];
+        }
+        // Validate region format
+        const validRegions = Object.values(regionMap);
+        if (!validRegions.includes(region)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid region "${args.region}". Valid regions are: ${Object.keys(regionMap).join(", ")} (or ${validRegions.join(", ")})`,
+                    },
+                ],
+            };
+        }
+        try {
+            const app = await client.createApp({
+                name: args.name,
+                region,
+                parseServerVersion: args.parseServerVersion,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ App created successfully!\n\n${JSON.stringify(app, null, 2)}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `❌ Failed to create app: ${message}\n\nRequest details:\n- Name: ${args.name}\n- Region: ${region}\n- Parse Server Version: ${args.parseServerVersion || "default"}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/apps/index.js.map

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

package/dist/tools/audit/index.d.ts

@@ -0,0 +1,6 @@
+import { ToolContext, ToolServer } from "../../context.js";
+import { Activity } from "../../client/sashido.js";
+/** One line: when, what, app, result, who, through what, message */
+export declare function describeActivity(a: Activity, appName: string | null): string;
+export declare function registerAuditTools(server: ToolServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/audit/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAwBnD,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAqB5E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAiC7E"}

package/dist/tools/audit/index.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+function describeActor(a) {
+    const actor = a.actor;
+    if (!actor) {
+        return "";
+    }
+    if (actor.kind === "access_token") {
+        return `token "${actor.tokenName || actor.tokenId}"`;
+    }
+    return actor.kind === "platform" ? "SashiDo" : "dashboard session";
+}
+function describeVia(a) {
+    const via = a.via;
+    if (!via || !via.client) {
+        return "";
+    }
+    const details = [via.mcpClient, via.mcpTool ? `tool ${via.mcpTool}` : ""].filter(Boolean).join(", ");
+    return `via ${via.client}${details ? ` (${details})` : ""}`;
+}
+/** One line: when, what, app, result, who, through what, message */
+export function describeActivity(a, appName) {
+    const result = a.result
+        ? a.result.status === "ok"
+            ? "ok"
+            : `${a.result.status}${a.result.code ? ` ${a.result.code}` : ""}${a.result.message ? `: ${a.result.message}` : ""}`
+        : "";
+    const params = (a.data && a.data.params) || {};
+    const count = a.type === "data_read_summary" ? `${params["count"]} reads of ${params["className"]}` : "";
+    return [
+        a.createdAt.replace("T", " ").slice(0, 19),
+        a.type,
+        appName,
+        result,
+        describeActor(a),
+        describeVia(a),
+        count,
+        a.source === "client" ? "(reported by the client)" : "",
+        a.data && a.data.message ? `- ${a.data.message}` : "",
+    ]
+        .filter(Boolean)
+        .join("  ");
+}
+export function registerAuditTools(server, ctx) {
+    server.tool("get_audit_log", "The account's activity, newest first: who did what, to which app, through what (dashboard, API token, this MCP server and its tool), and how it ended. Use it to find out what happened, e.g. who changed an app or what an AI client did.", {
+        type: z
+            .string()
+            .optional()
+            .describe("Only this kind, e.g. deploy, set_env, set_engine, parse_proxy_write, read_users, access_refused"),
+        app: z.string().optional().describe("Only this app: its name or objectId"),
+        page: z.number().int().min(1).optional().describe("Page of 50 (default 1)"),
+    }, async (args) => {
+        const appId = args.app ? await ctx.resolveApp(args.app) : null;
+        const activities = await ctx.sashido().listActivities({ type: args.type, page: args.page });
+        const shown = appId ? activities.filter((a) => a.app && a.app.objectId === appId) : activities;
+        if (!shown.length) {
+            return text(`No activity${args.type ? ` of type ${args.type}` : ""}${args.app ? ` for ${args.app}` : ""} on this page.`);
+        }
+        const lines = await Promise.all(shown.map(async (a) => describeActivity(a, a.app ? await ctx.appName(a.app.objectId) : null)));
+        return text([
+            `Activity, newest first (page ${args.page || 1}${appId ? `, filtered from ${activities.length}` : ""}):`,
+            ...lines,
+            activities.length === 50 ? `\nMore: page ${(args.page || 1) + 1}.` : "",
+        ]
+            .filter(Boolean)
+            .join("\n"));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/audit/index.js.map

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

package/dist/tools/builds/index.d.ts

@@ -0,0 +1,3 @@
+import { ToolContext, ToolServer } from "../../context.js";
+export declare function registerBuildTools(server: ToolServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/builds/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builds/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA8G7E"}

package/dist/tools/builds/index.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { SashidoClient } from "../../client/sashido.js";
+export function registerBuildTools(server, ctx) {
+    const getAuthFromRequest = (_args, _extra) => ctx.token;
+    // List Builds
+    server.tool("list_builds", "List build history for an application", {
+        appObjectId: z.string().describe("The application object ID"),
+        limit: z
+            .number()
+            .optional()
+            .describe("Maximum number of builds to return (default: 30)"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        const builds = await client.listBuilds(args.appObjectId, args.limit);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(builds, null, 2),
+                },
+            ],
+        };
+    });
+    // Build log
+    server.tool("get_build_log", "Get the log of a build, e.g. to find out why it failed. Returns the last lines, where errors show up, and whether the build is finished. Take buildId from list_builds.", {
+        appObjectId: z.string().describe("The application object ID"),
+        buildId: z.string().describe("The build's objectId, from list_builds"),
+        lines: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .optional()
+            .describe("How many of the last lines to return (default 300)"),
+    }, async (args) => {
+        const log = await ctx.sashido().getBuildLog(args.appObjectId, args.buildId, args.lines);
+        const header = [
+            `Build #${log.number ?? "?"} (${log.buildId}): ${log.phase ?? "unknown phase"}`,
+            log.finished ? "finished" : "still running",
+            log.truncated ? "showing the last lines only" : "",
+        ]
+            .filter(Boolean)
+            .join(" · ");
+        return {
+            content: [{ type: "text", text: `${header}\n\n${log.text || "(empty log)"}` }],
+        };
+    });
+    // Trigger Build
+    server.tool("trigger_build", "Trigger a new build for an application", {
+        appObjectId: z.string().describe("The application object ID"),
+        region: z.string().optional().describe("Target region (optional)"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        await client.triggerBuild(args.appObjectId, args.region);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Build triggered successfully for app ${args.appObjectId}`,
+                },
+            ],
+        };
+    });
+    // Cancel Build
+    server.tool("cancel_build", "Cancel a running build", {
+        appObjectId: z.string().describe("The application object ID"),
+        buildName: z.string().describe("The name of the build to cancel"),
+        region: z.string().optional().describe("Target region (optional)"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        await client.cancelBuild(args.appObjectId, args.buildName, args.region);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Build ${args.buildName} cancelled successfully`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/builds/index.js.map

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

package/dist/tools/classes/index.d.ts

@@ -0,0 +1,3 @@
+import { ToolContext, ToolServer } from '../../context.js';
+export declare function registerClassTools(server: ToolServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/classes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/classes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAoS7E"}