@sashido/mcp-server 0.0.0-stage → 0.2.0

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

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

package/dist/tools/env/index.js

@@ -0,0 +1,116 @@
+import { z } from "zod";
+import { SashidoClient } from "../../client/sashido.js";
+// SECURITY: Patterns that indicate sensitive env var names
+const SENSITIVE_PATTERNS = [
+    /key/i,
+    /secret/i,
+    /password/i,
+    /token/i,
+    /credential/i,
+    /api_key/i,
+    /apikey/i,
+    /private/i,
+    /auth/i,
+    /cert/i,
+    /database/i,
+    /mongodb/i,
+    /postgres/i,
+    /mysql/i,
+    /redis/i,
+    /aws/i,
+    /azure/i,
+    /gcp/i,
+    /stripe/i,
+    /twilio/i,
+    /sendgrid/i,
+];
+function isSensitiveEnvVar(name) {
+    return SENSITIVE_PATTERNS.some((pattern) => pattern.test(name));
+}
+function redactEnvVars(envVars) {
+    return envVars.map((env) => ({
+        name: env.name,
+        value: isSensitiveEnvVar(env.name) ? "[REDACTED]" : env.value,
+    }));
+}
+export function registerEnvTools(server, ctx) {
+    const getAuthFromRequest = (_args, _extra) => ctx.token;
+    // List Environment Variables
+    // SECURITY: Redacts values of sensitive env vars
+    server.tool("list_env_vars", "List environment variables for an application. Note: Sensitive values are redacted for security.", {
+        appObjectId: z.string().describe("The application object ID"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        const envVars = await client.listEnvVars(args.appObjectId);
+        // Redact sensitive values before returning
+        const redactedEnvVars = redactEnvVars(envVars);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(redactedEnvVars, null, 2),
+                },
+            ],
+        };
+    });
+    // Set Environment Variable
+    server.tool("set_env_var", "Set or update an environment variable for an application", {
+        appObjectId: z.string().describe("The application object ID"),
+        name: z.string().describe("Environment variable name"),
+        value: z.string().describe("Environment variable value"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        // Get current env vars
+        const currentEnvVars = await client.listEnvVars(args.appObjectId);
+        // Update or add the new variable
+        const envIndex = currentEnvVars.findIndex((e) => e.name === args.name);
+        if (envIndex >= 0) {
+            currentEnvVars[envIndex] = { name: args.name, value: args.value };
+        }
+        else {
+            currentEnvVars.push({ name: args.name, value: args.value });
+        }
+        await client.updateEnvVars(args.appObjectId, currentEnvVars);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Environment variable ${args.name} set successfully`,
+                },
+            ],
+        };
+    });
+    // Delete Environment Variable
+    server.tool("delete_env_var", "Delete an environment variable from an application", {
+        appObjectId: z.string().describe("The application object ID"),
+        name: z.string().describe("Environment variable name to delete"),
+    }, async (args, extra) => {
+        const auth = getAuthFromRequest(args, extra);
+        const client = new SashidoClient(auth);
+        // Get current env vars and remove the specified one
+        const currentEnvVars = await client.listEnvVars(args.appObjectId);
+        const filteredEnvVars = currentEnvVars.filter((e) => e.name !== args.name);
+        if (filteredEnvVars.length === currentEnvVars.length) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Environment variable ${args.name} not found`,
+                    },
+                ],
+            };
+        }
+        await client.updateEnvVars(args.appObjectId, filteredEnvVars);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Environment variable ${args.name} deleted successfully`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

package/dist/tools/files/index.js

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+// Helper to guess content type from filename
+function guessContentType(fileName) {
+    const ext = fileName.toLowerCase().split('.').pop();
+    const contentTypes = {
+        // Images
+        'jpg': 'image/jpeg',
+        'jpeg': 'image/jpeg',
+        'png': 'image/png',
+        'gif': 'image/gif',
+        'webp': 'image/webp',
+        'svg': 'image/svg+xml',
+        'ico': 'image/x-icon',
+        // Documents
+        'pdf': 'application/pdf',
+        'doc': 'application/msword',
+        'docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        'xls': 'application/vnd.ms-excel',
+        'xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        // Text
+        'txt': 'text/plain',
+        'csv': 'text/csv',
+        'json': 'application/json',
+        'xml': 'application/xml',
+        // Media
+        'mp3': 'audio/mpeg',
+        'mp4': 'video/mp4',
+        'wav': 'audio/wav',
+        // Archives
+        'zip': 'application/zip',
+        'gz': 'application/gzip',
+    };
+    return contentTypes[ext || ''] || 'application/octet-stream';
+}
+export function registerFileTools(server, ctx) {
+    const getParseClient = async (args, _extra) => ctx.parse(args.appObjectId);
+    // Upload File from Base64
+    server.tool('upload_file', 'Upload a file to Parse Server from base64-encoded data', {
+        appObjectId: z.string().describe('The application object ID'),
+        fileName: z.string().describe('The file name with extension (e.g., "image.png")'),
+        base64Data: z.string().describe('Base64-encoded file data'),
+        contentType: z
+            .string()
+            .optional()
+            .describe('Content type (e.g., "image/png"). Will be guessed from extension if not provided.'),
+    }, async (args, extra) => {
+        const parseClient = await getParseClient(args, extra);
+        const contentType = args.contentType || guessContentType(args.fileName);
+        const fileData = Buffer.from(args.base64Data, 'base64');
+        const result = await parseClient.uploadFile(args.fileName, fileData, contentType);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `File uploaded successfully!\n\nName: ${result.name}\nURL: ${result.url}\n\nTo use this file in an object, set the field value to:\n${JSON.stringify({ __type: 'File', name: result.name, url: result.url }, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Upload File from URL
+    server.tool('upload_file_from_url', 'Download a file from a URL and upload it to Parse Server', {
+        appObjectId: z.string().describe('The application object ID'),
+        sourceUrl: z.string().url().describe('The URL to download the file from'),
+        fileName: z
+            .string()
+            .optional()
+            .describe('Optional file name. Will be extracted from URL if not provided.'),
+    }, async (args, extra) => {
+        // Download file from URL
+        const response = await axios.get(args.sourceUrl, {
+            responseType: 'arraybuffer',
+            timeout: 30000,
+        });
+        // Extract filename from URL or use provided
+        let fileName = args.fileName;
+        if (!fileName) {
+            const urlPath = new URL(args.sourceUrl).pathname;
+            fileName = urlPath.split('/').pop() || 'file';
+        }
+        const contentType = response.headers['content-type'] || guessContentType(fileName);
+        const fileData = Buffer.from(response.data);
+        const parseClient = await getParseClient(args, extra);
+        const result = await parseClient.uploadFile(fileName, fileData, contentType);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `File uploaded successfully!\n\nSource: ${args.sourceUrl}\nName: ${result.name}\nURL: ${result.url}\nSize: ${fileData.length} bytes\n\nTo use this file in an object, set the field value to:\n${JSON.stringify({ __type: 'File', name: result.name, url: result.url }, null, 2)}`,
+                },
+            ],
+        };
+    });
+    // Upload File from local path (fastest - no LLM processing needed)
+    server.tool('upload_file_from_path', 'Upload a local file to Parse Server. This is the fastest method - just provide the file path.', {
+        appObjectId: z.string().describe('The application object ID'),
+        filePath: z.string().describe('Absolute path to the local file (e.g., "/Users/me/image.png")'),
+        fileName: z
+            .string()
+            .optional()
+            .describe('Optional custom file name. Will use original filename if not provided.'),
+    }, async (args, extra) => {
+        // Check if file exists
+        if (!fs.existsSync(args.filePath)) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: File not found at path: ${args.filePath}`,
+                    },
+                ],
+            };
+        }
+        // Read file from disk
+        const fileData = fs.readFileSync(args.filePath);
+        const fileName = args.fileName || path.basename(args.filePath);
+        const contentType = guessContentType(fileName);
+        const parseClient = await getParseClient(args, extra);
+        const result = await parseClient.uploadFile(fileName, fileData, contentType);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `File uploaded successfully!\n\nSource: ${args.filePath}\nName: ${result.name}\nURL: ${result.url}\nSize: ${fileData.length} bytes\n\nTo use this file in an object, set the field value to:\n${JSON.stringify({ __type: 'File', name: result.name, url: result.url }, null, 2)}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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

package/dist/tools/health/index.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export function registerHealthTools(server, ctx) {
+    const getParseClient = async (args, _extra) => ctx.parse(args.appObjectId);
+    // Check App Health
+    server.tool('check_app_health', 'Check if an application\'s Parse Server is healthy and running', {
+        appObjectId: z.string().describe('The application object ID'),
+    }, async (args, extra) => {
+        try {
+            const parseClient = await getParseClient(args, extra);
+            const health = await parseClient.checkHealth();
+            const statusEmoji = health.status === 'ok' ? '✅' : '⚠️';
+            const dbEmoji = health.database === 'ok' ? '✅' : '❌';
+            const output = [
+                `${statusEmoji} Status: ${health.status?.toString().toUpperCase() || 'UNKNOWN'}`,
+                `${dbEmoji} Database: ${health.database || 'unknown'}`,
+                ``,
+                `Parse Server: v${health.version || 'unknown'}`,
+                `Node.js: ${health.nodeVersion || 'unknown'}`,
+                `Region: ${health.region || 'unknown'}`,
+                ``,
+                `Build: #${health.build || 'N/A'}`,
+                `Deployment: #${health.deployment || 'N/A'}`,
+                `State: ${health.state || 'unknown'}`,
+            ].join('\n');
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: output,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Health check failed: ${message}\n\nThe app may be down, not deployed, or unreachable.`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/health/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,mBAAmB,CAAC,MAAkB,EAAE,GAAgB;IACtE,MAAM,cAAc,GAAG,KAAK,EAAE,IAA6B,EAAE,MAAgB,EAAE,EAAE,CAC/E,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9B,mBAAmB;IACnB,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,gEAAgE,EAChE;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC9D,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,CAAC;YAE/C,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YACxD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YAErD,MAAM,MAAM,GAAG;gBACb,GAAG,WAAW,YAAY,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,IAAI,SAAS,EAAE;gBAChF,GAAG,OAAO,cAAc,MAAM,CAAC,QAAQ,IAAI,SAAS,EAAE;gBACtD,EAAE;gBACF,kBAAkB,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE;gBAC/C,YAAY,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE;gBAC7C,WAAW,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE;gBACvC,EAAE;gBACF,WAAW,MAAM,CAAC,KAAK,IAAI,KAAK,EAAE;gBAClC,gBAAgB,MAAM,CAAC,UAAU,IAAI,KAAK,EAAE;gBAC5C,UAAU,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE;aACtC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YACzE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,0BAA0B,OAAO,wDAAwD;qBAChG;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/infrastructure/deployments.d.ts

@@ -0,0 +1,23 @@
+import { Deployment, SashidoClient } from "../../client/sashido.js";
+export declare const IN_PROGRESS: string[];
+export interface DeploymentState {
+    /** The deployment whose containers report now */
+    serving: {
+        name: string;
+        number: number;
+        containers: number;
+    } | null;
+    /** The deployment history, newest first; null when it can't be read */
+    records: Deployment[] | null;
+    /** In progress in the history, recently started: can be cancelled */
+    rolling: Deployment | null;
+    /** "In progress" in the history for too long: never ended there */
+    stuck: Deployment[];
+}
+/** The history's record of a deployment started after `before`, if any */
+export declare function newRecord(client: SashidoClient, appObjectId: string, before: DeploymentState): Promise<Deployment | null>;
+export declare function deploymentState(client: SashidoClient, appObjectId: string): Promise<DeploymentState>;
+/** Of the records in progress before, one that ended badly since */
+export declare function endedBadly(state: DeploymentState, watched: string[]): Deployment | null;
+export declare function describeDeploymentState(state: DeploymentState): string[];
+//# sourceMappingURL=deployments.d.ts.map

package/dist/tools/infrastructure/deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/deployments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAQpE,eAAO,MAAM,WAAW,UAAgC,CAAC;AAKzD,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrE,uEAAuE;IACvE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAOD,0EAA0E;AAC1E,wBAAsB,SAAS,CAC7B,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAW5B;AAID,wBAAsB,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAoB1G;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAEvF;AAID,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CA0BxE"}

package/dist/tools/infrastructure/deployments.js

@@ -0,0 +1,76 @@
+// Two numberings, never compared with each other:
+// - what serves traffic: the app's running instances, as they report now
+// - the deployment history the dashboard shows, with its own numbering;
+//   cancel_deployment takes these names. Not every rollout appears in it,
+//   so it never decides what serves.
+export const IN_PROGRESS = ["New", "Pending", "Running"];
+const ENDED_BADLY = ["Failed", "Cancelled", "Error"];
+// a record still "in progress" after this is stuck, not rolling out
+const STUCK_AFTER_MS = 30 * 60 * 1000;
+// how long deploy_app looks for the new deployment in the history (tests
+// make it short)
+const RECORD_POLL_MS = Number(process.env.SASHIDO_POLL_MS) || 1500;
+const RECORD_POLLS = 4;
+/** The history's record of a deployment started after `before`, if any */
+export async function newRecord(client, appObjectId, before) {
+    const known = new Set((before.records || []).map((d) => d.objectId));
+    for (let i = 0; i < RECORD_POLLS; i++) {
+        await new Promise((resolve) => setTimeout(resolve, RECORD_POLL_MS));
+        const records = await client.listDeployments(appObjectId, 5).catch(() => null);
+        const found = (records || []).find((d) => !known.has(d.objectId));
+        if (found) {
+            return found;
+        }
+    }
+    return null;
+}
+const age = (d) => Date.now() - Date.parse(d.createdAt);
+export async function deploymentState(client, appObjectId) {
+    const [live, records] = await Promise.all([
+        client.getActiveDeployment(appObjectId).catch(() => null),
+        client.listDeployments(appObjectId, 5).catch(() => null),
+    ]);
+    const serving = live && live.deploymentName && live.deploymentNumber !== null
+        ? {
+            name: live.deploymentName,
+            number: live.deploymentNumber,
+            containers: Object.keys(live.processes || {}).length,
+        }
+        : null;
+    const inProgress = (records || []).filter((d) => IN_PROGRESS.includes(d.phase));
+    return {
+        serving,
+        records,
+        rolling: inProgress.find((d) => age(d) < STUCK_AFTER_MS) || null,
+        stuck: inProgress.filter((d) => age(d) >= STUCK_AFTER_MS),
+    };
+}
+/** Of the records in progress before, one that ended badly since */
+export function endedBadly(state, watched) {
+    return (state.records || []).find((d) => watched.includes(d.objectId) && ENDED_BADLY.includes(d.phase)) || null;
+}
+const minutes = (ms) => `${Math.max(1, Math.round(ms / 60000))} min`;
+export function describeDeploymentState(state) {
+    const lines = [
+        state.serving
+            ? `Serving traffic: ${state.serving.name}, ${state.serving.containers} container${state.serving.containers === 1 ? "" : "s"} reporting.`
+            : "Serving traffic: no containers report now (the app may be stopped, or just being deployed).",
+    ];
+    if (!state.records) {
+        return lines;
+    }
+    if (state.rolling) {
+        lines.push(`Rolling out: ${state.rolling.name}, ${state.rolling.phase} for ${minutes(age(state.rolling))}. wait_for_deployment waits for it; cancel_deployment with deploymentName="${state.rolling.name}" stops it.`);
+    }
+    else {
+        lines.push("No deployment in the history is rolling out.");
+    }
+    for (const d of state.stuck) {
+        lines.push(`${d.name} shows ${d.phase} for ${minutes(age(d))}: it never ended in the history (not rolling out).`);
+    }
+    if (state.records.length) {
+        lines.push("Deployment history (the dashboard's numbering, which may miss some deployments):", ...state.records.map((d) => `  ${d.name}: ${d.phase}, ${d.createdAt.replace("T", " ").slice(0, 16)}`));
+    }
+    return lines;
+}
+//# sourceMappingURL=deployments.js.map

package/dist/tools/infrastructure/deployments.js.map

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

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

@@ -0,0 +1,9 @@
+import { ToolContext, ToolServer } from "../../context.js";
+import { App } from "../../client/sashido.js";
+import { DeploymentState } from "./deployments.js";
+/** "release-6.5.11-preview" -> "6.5.11 (preview)" */
+export declare function versionLabel(tag?: string): string;
+/** What runs the app: version, engine, scaling, HA, deployments */
+export declare function describeInfrastructure(app: App, state: DeploymentState | null): string;
+export declare function registerInfrastructureTools(server: ToolServer, ctx: ToolContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/infrastructure/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAsB,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAwD,MAAM,kBAAkB,CAAC;AAQzG,qDAAqD;AACrD,wBAAgB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAUjD;AAID,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,MAAM,CAuBtF;AAUD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CA8HtF"}

package/dist/tools/infrastructure/index.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import { deploymentState, describeDeploymentState, endedBadly } from "./deployments.js";
+// how often wait_for_deployment looks (tests make it short)
+const POLL_MS = Number(process.env.SASHIDO_POLL_MS) || 5000;
+// time a poll's API calls may take, kept free before the deadline
+const POLL_SLACK_MS = POLL_MS >= 1000 ? 8000 : 0;
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+/** "release-6.5.11-preview" -> "6.5.11 (preview)" */
+export function versionLabel(tag) {
+    if (!tag) {
+        return "unknown";
+    }
+    const bare = tag.replace(/^release-/, "");
+    const match = /^(\d+\.\d+\.\d+)(?:-(.+))?$/.exec(bare);
+    if (!match) {
+        return bare;
+    }
+    return match[2] ? `${match[1]} (${match[2].replace(/-/g, ", ")})` : match[1];
+}
+const major = (tag) => Number((/(\d+)\./.exec(tag || "") || [])[1] || 0);
+/** What runs the app: version, engine, scaling, HA, deployments */
+export function describeInfrastructure(app, state) {
+    const settings = app.settings || {};
+    const engine = (settings.engine || {})[app.region];
+    const replicas = app.deployment && app.deployment.replicas;
+    const limits = settings.engine_scaling_config || {};
+    const lines = [
+        `${app.name} (${app.objectId}), region ${app.region}`,
+        `Parse Server: ${versionLabel(app.parseServerVersion)}${app.parseServerVersion ? ` [${app.parseServerVersion}]` : ""}`,
+        // never guess: older APIs don't tell the engine at all
+        `Engine: ${engine ? `${engine.name}, billed ${engine.billingPolicy}` : settings.engine ? "the default (Development 1X)" : "unknown (the API doesn't tell yet)"}`,
+        replicas
+            ? `Scaling: ${replicas.auto ? `auto, ${replicas.min} to ${replicas.max} engines` : `fixed, ${replicas.min} engine${replicas.min === 1 ? "" : "s"}`}`
+            : "Scaling: unknown",
+        // newer APIs tell the version and engine; then no HA flag means off
+        `High availability: ${settings.highly_available ? "on" : settings.highly_available === false || app.parseServerVersion ? "off" : "unknown"}`,
+    ];
+    if (limits.max) {
+        lines.push(`Your plan allows up to ${limits.max} engines for this app.`);
+    }
+    if (state) {
+        lines.push("", ...describeDeploymentState(state));
+    }
+    return lines.join("\n");
+}
+async function findApp(ctx, appObjectId) {
+    const app = (await ctx.sashido().listApps()).find((a) => a.objectId === appObjectId);
+    if (!app) {
+        throw new Error(`App ${appObjectId} not found.`);
+    }
+    return app;
+}
+export function registerInfrastructureTools(server, ctx) {
+    server.tool("get_app_infrastructure", "What runs an app: its Parse Server version, engine and billing, scaling, high availability, and its deployments (whether one is rolling out). Check it before changing any of them.", {
+        appObjectId: z.string().describe("The application object ID"),
+    }, async (args) => {
+        const app = await findApp(ctx, args.appObjectId);
+        const state = ctx.access.scopes.indexOf("apps:read") !== -1 ? await deploymentState(ctx.sashido(), app.objectId) : null;
+        return text(describeInfrastructure(app, state));
+    });
+    server.tool("wait_for_deployment", "Wait until a newer deployment of the app serves traffic, e.g. after deploy_app, set_env_var, set_engine or change_parse_server_version, and say how it went. Returns before clients give up on the call (timeoutSeconds): call it again if it's still rolling out.", {
+        appObjectId: z.string().describe("The application object ID"),
+        timeoutSeconds: z
+            .number()
+            .int()
+            .min(5)
+            .max(300)
+            .optional()
+            .describe("How long to wait at most (default 45; some clients give up on calls after 60s)"),
+        after: z
+            .number()
+            .int()
+            .optional()
+            .describe("Wait for a deployment newer than this number: the one deploy_app or change_parse_server_version tell, or the previous wait_for_deployment's. Default: the one serving now"),
+    }, async (args) => {
+        const client = ctx.sashido();
+        const deadline = Date.now() + (args.timeoutSeconds || 45) * 1000;
+        const start = await deploymentState(client, args.appObjectId);
+        // counted in the numbering of what serves (the containers)
+        const before = args.after !== undefined ? args.after : start.serving ? start.serving.number : 0;
+        // the history's deployments in progress now, or started from here on
+        const known = new Set((start.records || []).map((d) => d.objectId));
+        const watched = (start.rolling ? [start.rolling.objectId] : []).slice();
+        // without after, nothing was just requested: say so if nothing rolls out
+        const quietBy = args.after === undefined ? Date.now() + 30000 : Infinity;
+        let state = start;
+        for (;;) {
+            if (state.serving && state.serving.number > before) {
+                return text(`${state.serving.name} serves traffic now, ${state.serving.containers} container${state.serving.containers === 1 ? "" : "s"} reporting.`);
+            }
+            for (const d of state.records || []) {
+                if (!known.has(d.objectId)) {
+                    known.add(d.objectId);
+                    watched.push(d.objectId);
+                }
+            }
+            const failed = endedBadly(state, watched);
+            if (failed) {
+                return text(`${failed.name} ended: ${failed.phase}. ${state.serving ? `${state.serving.name} still serves traffic. ` : ""}Check get_build_log and get_error_logs.`);
+            }
+            if (!state.rolling && watched.length === 0 && Date.now() > quietBy) {
+                return text(`Nothing is rolling out. ${describeDeploymentState(state)[0]}`);
+            }
+            if (Date.now() + POLL_MS + POLL_SLACK_MS > deadline) {
+                return text(`${state.rolling ? `Still rolling out: ${state.rolling.name} (${state.rolling.phase}).` : `No newer deployment serves traffic yet${state.serving ? ` (${state.serving.name} still does)` : ""}.`} Deployments usually take one to three minutes: call wait_for_deployment again with after: ${before}.`);
+            }
+            await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+            state = await deploymentState(client, args.appObjectId);
+        }
+    });
+    server.tool("list_parse_server_versions", "The Parse Server versions apps can be created on (create_app) or switched to (change_parse_server_version), newest first.", {}, async () => {
+        const versions = await ctx.sashido().listParseServerVersions();
+        return text(formatVersions(versions));
+    });
+    server.tool("change_parse_server_version", "Switch an app to another Parse Server version; the app is redeployed. A new major version can break cloud code and clients: read the Parse Server migration guides first. Without confirm: true it only shows what would change.", {
+        appObjectId: z.string().describe("The application object ID"),
+        imageTag: z.string().describe("The version's imageTag, from list_parse_server_versions"),
+        confirm: z.boolean().optional().describe("true to switch; otherwise only a preview"),
+    }, async (args) => {
+        const client = ctx.sashido();
+        const [app, versions] = await Promise.all([findApp(ctx, args.appObjectId), client.listParseServerVersions()]);
+        const target = versions.find((v) => v.imageTag === args.imageTag);
+        if (!target) {
+            return text(`❌ ${args.imageTag} isn't a version apps can use.\n\n${formatVersions(versions)}`);
+        }
+        if (app.parseServerVersion === target.imageTag) {
+            return text(`${app.name} already runs Parse Server ${versionLabel(target.imageTag)}.`);
+        }
+        const from = app.parseServerVersion;
+        const crossesMajor = major(from) !== major(target.imageTag);
+        const summary = [
+            `${app.name}: Parse Server ${versionLabel(from)} → ${versionLabel(target.imageTag)}`,
+            crossesMajor
+                ? `This changes the major version (${major(from)} → ${major(target.imageTag)}): cloud code and client SDKs may need changes. Try it on a test app first.`
+                : "Same major version.",
+            "The app is redeployed; during a deployment without high availability it may be briefly unavailable.",
+        ];
+        if (!args.confirm) {
+            return text(`Preview (nothing changed):\n${summary.join("\n")}\n\nCall again with confirm: true to switch.`);
+        }
+        const serving = (await deploymentState(client, app.objectId)).serving;
+        await client.changeParseServerVersion(app.objectId, target.imageTag);
+        return text(`✅ Switching.\n${summary.join("\n")}\n\nwait_for_deployment with after: ${serving ? serving.number : 0} shows when the new version serves traffic.`);
+    });
+}
+function formatVersions(versions) {
+    const sorted = [...versions].sort((a, b) => compareTags(b.imageTag, a.imageTag));
+    return [
+        "Parse Server versions (newest first):",
+        ...sorted.map((v) => `  ${versionLabel(v.imageTag)} [${v.imageTag}]${v.latest ? " ← default for new apps" : ""}`),
+    ].join("\n");
+}
+function compareTags(a, b) {
+    const parts = (t) => ((/(\d+)\.(\d+)\.(\d+)/.exec(t) || []).slice(1).map(Number));
+    const x = parts(a);
+    const y = parts(b);
+    for (let i = 0; i < 3; i++) {
+        if ((x[i] || 0) !== (y[i] || 0)) {
+            return (x[i] || 0) - (y[i] || 0);
+        }
+    }
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+//# sourceMappingURL=index.js.map