@studiometa/forge-mcp 0.4.8 → 0.5.0

package/dist/{version-Cc6wPkZg.js → version-DmcOqxKX.js}

@@ -1,8 +1,8 @@
 import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { HttpClient, isForgeApiError } from "@studiometa/forge-api";
-import { PHP_CONFIG_TYPES, RESOURCES, activateCertificate, createAuditLogger, createBackupConfig, createCertificate, createCommand, createDaemon, createDatabase, createDatabaseUser, createFirewallRule, createMonitor, createNginxTemplate, createRecipe, createRedirectRule, createScheduledJob, createSecurityRule, createServer, createSite, createSshKey, deleteBackupConfig, deleteCertificate, deleteDaemon, deleteDatabase, deleteDatabaseUser, deleteFirewallRule, deleteMonitor, deleteNginxTemplate, deleteRecipe, deleteRedirectRule, deleteScheduledJob, deleteSecurityRule, deleteServer, deleteSite, deleteSshKey, deploySiteAndWait, disablePhpOpcache, enablePhpOpcache, getBackupConfig, getCertificate, getCommand, getDaemon, getDaemonLog, getDatabase, getDatabaseUser, getDeploymentLog, getDeploymentScript, getEnv, getFirewallRule, getMonitor, getNginxConfig, getNginxTemplate, getPhpConfig, getPhpMaxExecutionTime, getPhpMaxUploadSize, getPhpOpcache, getPhpVersion, getRecipe, getRedirectRule, getScheduledJob, getSecurityRule, getServer, getSite, getSshKey, getUser, listBackupConfigs, listCommands, listDaemons, listDatabaseUsers, listDatabases, listDeployments, listFirewallRules, listMonitors, listNginxTemplates, listPhpVersions, listRecipes, listRedirectRules, listScheduledJobs, listSecurityRules, listServers, listServices, listSites, listSshKeys, rebootServer, resolveServers, resolveSites, restartDaemon, restartService, runRecipe, updateBackupConfig, updateDaemon, updateDatabaseUser, updateDeploymentScript, updateEnv, updateNginxConfig, updateNginxTemplate, updatePhpConfig, updatePhpMaxExecutionTime, updatePhpMaxUploadSize, updateRecipe, updateSecurityRule, updateSite } from "@studiometa/forge-core";
+import { HttpClient, STORAGE_PROVIDER_TYPES, isForgeApiError } from "@studiometa/forge-api";
+import { PHP_CONFIG_TYPES, RESOURCES, activateCertificate, createAuditLogger, createBackupConfig, createCertificate, createCommand, createDaemon, createDatabase, createDatabaseUser, createFirewallRule, createMonitor, createNginxTemplate, createRecipe, createRedirectRule, createScheduledJob, createSecurityRule, createServer, createSite, createSshKey, createStorageProvider, deleteBackupConfig, deleteCertificate, deleteDaemon, deleteDatabase, deleteDatabaseUser, deleteFirewallRule, deleteMonitor, deleteNginxTemplate, deleteRecipe, deleteRedirectRule, deleteScheduledJob, deleteSecurityRule, deleteServer, deleteSite, deleteSshKey, deleteStorageProvider, deploySiteAndWait, disablePhpOpcache, enablePhpOpcache, getBackupConfig, getCertificate, getCommand, getDaemon, getDaemonLog, getDatabase, getDatabaseUser, getDeploymentLog, getDeploymentScript, getEnv, getFirewallRule, getMonitor, getNginxConfig, getNginxTemplate, getPhpConfig, getPhpMaxExecutionTime, getPhpMaxUploadSize, getPhpOpcache, getPhpVersion, getRecipe, getRedirectRule, getScheduledJob, getSecurityRule, getServer, getSite, getSshKey, getStorageProvider, getUser, listBackupConfigs, listCommands, listDaemons, listDatabaseUsers, listDatabases, listDeployments, listFirewallRules, listMonitors, listNginxTemplates, listPhpVersions, listRecipes, listRedirectRules, listScheduledJobs, listSecurityRules, listServers, listServices, listSites, listSshKeys, listStorageProviders, rebootServer, resolveServers, resolveSites, restartDaemon, restartService, runRecipe, updateBackupConfig, updateDaemon, updateDatabaseUser, updateDeploymentScript, updateEnv, updateNginxConfig, updateNginxTemplate, updatePhpConfig, updatePhpMaxExecutionTime, updatePhpMaxUploadSize, updateRecipe, updateSecurityRule, updateSite } from "@studiometa/forge-core";
 //#region src/instructions.ts
 /**
 * MCP Server Instructions
@@ -185,6 +185,22 @@ function integer(message$1) {
 	};
 }
 /* @__NO_SIDE_EFFECTS__ */
+function minLength(requirement, message$1) {
+	return {
+		kind: "validation",
+		type: "min_length",
+		reference: minLength,
+		async: false,
+		expects: `>=${requirement}`,
+		requirement,
+		message: message$1,
+		"~run"(dataset, config$1) {
+			if (dataset.typed && dataset.value.length < this.requirement) _addIssue(this, "length", dataset, config$1, { received: `${dataset.value.length}` });
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
 function minValue(requirement, message$1) {
 	return {
 		kind: "validation",
@@ -898,6 +914,28 @@ function formatBackupConfig(backup) {
 	].join("\n");
 }
 /**
+* Format a list of storage providers.
+*/
+function formatStorageProviderList(providers) {
+	if (providers.length === 0) return "No storage providers found.";
+	const lines = providers.map((p) => `• ${p.name} (ID: ${p.id}) — ${p.provider_name} — bucket: ${p.bucket ?? "—"}${p.in_use ? " — in use" : ""}`);
+	return `${providers.length} storage provider(s):\n${lines.join("\n")}`;
+}
+/**
+* Format a single storage provider. Forge never returns the keys.
+*/
+function formatStorageProvider(provider) {
+	return [
+		`Storage Provider: ${provider.name} (ID: ${provider.id})`,
+		`Provider: ${provider.provider_name} (${provider.provider})`,
+		`Endpoint: ${provider.endpoint ?? "—"}`,
+		`Region: ${provider.region ?? "—"}`,
+		`Bucket: ${provider.bucket ?? "—"}`,
+		`Directory: ${provider.directory ?? "—"}`,
+		`In use: ${provider.in_use ? "yes" : "no"}`
+	].join("\n");
+}
+/**
 * Format a list of recipes.
 */
 function formatRecipeList(recipes) {
@@ -1133,10 +1171,23 @@ var handleBackups = createResourceHandler({
 		}),
 		create: /* @__PURE__ */ object({
 			server_id: /* @__PURE__ */ string(),
-			provider: /* @__PURE__ */ string(),
-			frequency: /* @__PURE__ */ string(),
-			credentials: /* @__PURE__ */ unknown(),
-			databases: /* @__PURE__ */ unknown()
+			storage_provider_id: /* @__PURE__ */ number(),
+			frequency: /* @__PURE__ */ picklist([
+				"hourly",
+				"daily",
+				"weekly",
+				"custom"
+			]),
+			retention: /* @__PURE__ */ number(),
+			database_ids: /* @__PURE__ */ pipe(/* @__PURE__ */ array(/* @__PURE__ */ number()), /* @__PURE__ */ minLength(1)),
+			include_new_databases: /* @__PURE__ */ optional(/* @__PURE__ */ boolean()),
+			name: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			bucket: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			directory: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			day: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
+			time: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
+			cron: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
+			notification_email: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string()))
 		}),
 		update: /* @__PURE__ */ object({
 			server_id: /* @__PURE__ */ string(),
@@ -1382,11 +1433,11 @@ var TOOLS = [{
 			},
 			provider: {
 				type: "string",
-				description: "Server provider (e.g. ocean2, linode, aws)"
+				description: "Server provider (e.g. ocean2, linode, aws), or storage provider type (s3, spaces, hetzner, ovh, scaleway, custom)"
 			},
 			region: {
 				type: "string",
-				description: "Server region (e.g. nyc3, us-east-1)"
+				description: "Server region (e.g. nyc3, us-east-1), or storage provider bucket region"
 			},
 			size: {
 				type: "string",
@@ -1459,7 +1510,60 @@ var TOOLS = [{
 			},
 			frequency: {
 				type: "string",
-				description: "Cron frequency for scheduled jobs (e.g. minutely, hourly, nightly, custom)"
+				description: "Frequency: scheduled jobs (minutely, hourly, nightly, custom) or backups (hourly, daily, weekly, custom)"
+			},
+			endpoint: {
+				type: "string",
+				description: "S3 endpoint URL for storage providers (e.g. https://s3.example.com)"
+			},
+			bucket: {
+				type: "string",
+				description: "Bucket for storage providers and backups"
+			},
+			directory: {
+				type: "string",
+				description: "Directory in the bucket for storage providers and backups"
+			},
+			access_key: {
+				type: "string",
+				description: "Storage provider access key ID"
+			},
+			secret_key: {
+				type: "string",
+				description: "Storage provider secret access key"
+			},
+			storage_provider_id: {
+				type: "number",
+				description: "Storage provider ID for backups (from storage-providers list)"
+			},
+			retention: {
+				type: "number",
+				description: "Number of backups to keep (1-8760)"
+			},
+			database_ids: {
+				type: "array",
+				description: "Database IDs to back up (at least one)",
+				items: { type: "number" }
+			},
+			include_new_databases: {
+				type: "boolean",
+				description: "Backups: also back up databases created later"
+			},
+			day: {
+				type: "string",
+				description: "Weekly backups: day of week, 0 (Sunday) to 6"
+			},
+			time: {
+				type: "string",
+				description: "Daily or weekly backups: HH:MM on the hour or half hour (e.g. 02:00)"
+			},
+			cron: {
+				type: "string",
+				description: "Custom backups: cron expression"
+			},
+			notification_email: {
+				type: "string",
+				description: "Backups: email notified when a backup fails"
 			},
 			script: {
 				type: "string",
@@ -3137,35 +3241,99 @@ var RESOURCE_HELP = {
 		}]
 	},
 	backups: {
-		description: "Manage backup configurations — automated database backups to S3, Spaces, or other providers",
+		description: "Manage database backup configurations — scheduled database backups to a storage provider (see storage-providers)",
 		scope: "server (requires server_id)",
 		actions: {
 			list: "List backup configurations on a server",
 			get: "Get backup config details (databases, schedule, retention)",
 			create: "Create a new backup configuration",
+			update: "Update a backup configuration (send every required field)",
 			delete: "Delete a backup configuration"
 		},
 		fields: {
-			provider: "Backup provider (s3, spaces, custom)",
-			credentials: "Provider credentials (keys, bucket, region)",
-			schedule: "Backup schedule (daily, weekly, custom cron)",
-			databases: "Array of database IDs to back up",
-			retention: "Number of backups to retain"
+			storage_provider_id: "Storage provider ID (from storage-providers list)",
+			frequency: "hourly, daily, weekly or custom",
+			day: "Weekly: day of week, 0 (Sunday) to 6",
+			time: "Daily or weekly: HH:MM on the hour or half hour, e.g. 02:00",
+			cron: "Custom: cron expression",
+			retention: "Number of backups to keep (1-8760)",
+			database_ids: "Array of database IDs to back up (at least one)",
+			include_new_databases: "Also back up databases created later",
+			bucket: "Bucket (overrides the provider bucket)",
+			directory: "Directory in the bucket",
+			notification_email: "Email notified when a backup fails"
+		},
+		examples: [
+			{
+				description: "List backup configs",
+				params: {
+					resource: "backups",
+					action: "list",
+					server_id: "123"
+				}
+			},
+			{
+				description: "Get backup config details",
+				params: {
+					resource: "backups",
+					action: "get",
+					server_id: "123",
+					id: "456"
+				}
+			},
+			{
+				description: "Back up two databases every day at 02:00 and keep 7 backups",
+				params: {
+					resource: "backups",
+					action: "create",
+					server_id: "123",
+					storage_provider_id: 7,
+					frequency: "daily",
+					time: "02:00",
+					retention: 7,
+					directory: "web-1",
+					database_ids: [11, 12]
+				}
+			}
+		]
+	},
+	"storage-providers": {
+		description: "Manage the organization's storage providers — S3-compatible buckets used by database backups",
+		scope: "global (no parent ID needed)",
+		actions: {
+			list: "List storage providers (filter with provider, e.g. custom)",
+			get: "Get storage provider details (keys are never returned)",
+			create: "Create a storage provider",
+			delete: "Delete a storage provider (fails when a backup configuration uses it)"
+		},
+		fields: {
+			name: "Provider name",
+			provider: "s3, spaces, hetzner, ovh, scaleway or custom (S3 compatible)",
+			endpoint: "S3 endpoint URL (custom providers)",
+			region: "Bucket region",
+			bucket: "Default bucket",
+			directory: "Default directory",
+			access_key: "Access key ID",
+			secret_key: "Secret access key"
 		},
 		examples: [{
-			description: "List backup configs",
+			description: "List storage providers",
 			params: {
-				resource: "backups",
-				action: "list",
-				server_id: "123"
+				resource: "storage-providers",
+				action: "list"
 			}
 		}, {
-			description: "Get backup config details",
+			description: "Create a custom S3-compatible provider",
 			params: {
-				resource: "backups",
-				action: "get",
-				server_id: "123",
-				id: "456"
+				resource: "storage-providers",
+				action: "create",
+				name: "Backups",
+				provider: "custom",
+				endpoint: "https://s3.example.com",
+				region: "eu-west-1",
+				bucket: "my-bucket",
+				access_key: "<access-key>",
+				secret_key: "<secret-key>"
 			}
 		}]
 	},
@@ -4288,6 +4456,7 @@ var RESOURCE_SCHEMAS = {
 			"list",
 			"get",
 			"create",
+			"update",
 			"delete"
 		],
 		scope: "server",
@@ -4296,41 +4465,121 @@ var RESOURCE_SCHEMAS = {
 			get: ["server_id", "id"],
 			create: [
 				"server_id",
-				"provider",
-				"credentials",
+				"storage_provider_id",
 				"frequency",
-				"databases"
+				"retention",
+				"database_ids"
+			],
+			update: [
+				"server_id",
+				"id",
+				"storage_provider_id",
+				"frequency",
+				"retention",
+				"database_ids"
 			],
 			delete: ["server_id", "id"]
 		},
 		create: {
-			provider: {
+			storage_provider_id: {
 				required: true,
-				type: "string — s3, spaces, custom"
+				type: "number — storage provider ID"
 			},
-			credentials: {
+			frequency: {
 				required: true,
-				type: "object — provider credentials (key, secret, etc.)"
+				type: "string — hourly, daily, weekly, custom"
 			},
-			frequency: {
+			retention: {
 				required: true,
-				type: "string — daily, weekly, custom"
+				type: "number — backups to keep (1-8760)"
 			},
-			databases: {
+			database_ids: {
 				required: true,
-				type: "array — database IDs to back up"
+				type: "number[] — database IDs to back up (at least one)"
+			},
+			include_new_databases: {
+				required: false,
+				type: "boolean — also back up new databases"
+			},
+			name: {
+				required: false,
+				type: "string — configuration name"
+			},
+			bucket: {
+				required: false,
+				type: "string — bucket (overrides the provider bucket)"
 			},
 			directory: {
 				required: false,
-				type: "string — backup directory"
+				type: "string — directory in the bucket"
 			},
-			email: {
+			day: {
 				required: false,
-				type: "string — notification email"
+				type: "string — weekly: day of week, 0 (Sunday) to 6"
 			},
-			retention: {
+			time: {
+				required: false,
+				type: "string — daily/weekly: HH:MM on the hour or half hour"
+			},
+			cron: {
+				required: false,
+				type: "string — custom: cron expression"
+			},
+			notification_email: {
 				required: false,
-				type: "number — backups to retain (default: 7)"
+				type: "string — email notified on failure"
+			}
+		}
+	},
+	"storage-providers": {
+		actions: [
+			"list",
+			"get",
+			"create",
+			"delete"
+		],
+		scope: "global",
+		required: {
+			get: ["id"],
+			create: ["name", "provider"],
+			delete: ["id"]
+		},
+		create: {
+			name: {
+				required: true,
+				type: "string — provider name"
+			},
+			provider: {
+				required: true,
+				type: "string — s3, spaces, hetzner, ovh, scaleway, custom"
+			},
+			endpoint: {
+				required: false,
+				type: "string — S3 endpoint URL (custom providers)"
+			},
+			region: {
+				required: false,
+				type: "string — bucket region"
+			},
+			bucket: {
+				required: false,
+				type: "string — default bucket"
+			},
+			directory: {
+				required: false,
+				type: "string — default directory"
+			},
+			access_key: {
+				required: false,
+				type: "string — access key ID"
+			},
+			secret_key: {
+				required: false,
+				type: "string — secret access key"
+			},
+			assume_role: {
+				required: false,
+				type: "boolean — use the EC2 instance role (s3)"
 			}
 		}
 	},
@@ -4858,6 +5107,48 @@ var handleSshKeys = createResourceHandler({
 	}
 });
 //#endregion
+//#region src/handlers/storage-providers.ts
+var handleStorageProviders = createResourceHandler({
+	resource: "storage-providers",
+	actions: [
+		"list",
+		"get",
+		"create",
+		"delete"
+	],
+	inputSchemas: {
+		get: /* @__PURE__ */ object({ id: /* @__PURE__ */ string() }),
+		create: /* @__PURE__ */ object({
+			name: /* @__PURE__ */ string(),
+			provider: /* @__PURE__ */ picklist(STORAGE_PROVIDER_TYPES),
+			region: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
+			bucket: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			directory: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			endpoint: /* @__PURE__ */ optional(/* @__PURE__ */ string()),
+			access_key: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			secret_key: /* @__PURE__ */ optional(/* @__PURE__ */ nullable(/* @__PURE__ */ string())),
+			assume_role: /* @__PURE__ */ optional(/* @__PURE__ */ boolean())
+		}),
+		delete: /* @__PURE__ */ object({ id: /* @__PURE__ */ string() })
+	},
+	executors: {
+		list: listStorageProviders,
+		get: getStorageProvider,
+		create: createStorageProvider,
+		delete: deleteStorageProvider
+	},
+	formatResult: (action, data, args) => {
+		switch (action) {
+			case "list": return formatStorageProviderList(data);
+			case "get":
+			case "create": return formatStorageProvider(data);
+			case "delete": return `Storage provider ${args.id} deleted.`;
+			/* v8 ignore next */
+			default: return "Done.";
+		}
+	}
+});
+//#endregion
 //#region src/handlers/user.ts
 var handleUser = createResourceHandler({
 	resource: "user",
@@ -4962,6 +5253,7 @@ function routeToHandler(resource, action, args, ctx) {
 		case "nginx-templates": return handleNginxTemplates(action, args, ctx);
 		case "recipes": return handleRecipes(action, args, ctx);
 		case "backups": return handleBackups(action, args, ctx);
+		case "storage-providers": return handleStorageProviders(action, args, ctx);
 		case "commands": return handleCommands(action, args, ctx);
 		case "scheduled-jobs": return handleScheduledJobs(action, args, ctx);
 		case "services": return handleServices(action, args, ctx);
@@ -5055,8 +5347,8 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 //#endregion
 //#region src/version.ts
-var VERSION = "0.4.8";
+var VERSION = "0.5.0";
 //#endregion
 export { INSTRUCTIONS as a, getTools as i, executeToolWithCredentials as n, STDIO_ONLY_TOOLS as r, VERSION as t };
 
-//# sourceMappingURL=version-Cc6wPkZg.js.map
+//# sourceMappingURL=version-DmcOqxKX.js.map