@studiometa/forge-mcp 0.4.6 → 0.4.7

package/dist/{version-BS77BDou.js → version-DAzDjx0T.js}

@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { HttpClient, isForgeApiError } from "@studiometa/forge-api";
-import { 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, getBackupConfig, getCertificate, getCommand, getDaemon, getDaemonLog, getDatabase, getDatabaseUser, getDeploymentLog, getDeploymentScript, getEnv, getFirewallRule, getMonitor, getNginxConfig, getNginxTemplate, getRecipe, getRedirectRule, getScheduledJob, getSecurityRule, getServer, getSite, getSshKey, getUser, listBackupConfigs, listCommands, listDaemons, listDatabaseUsers, listDatabases, listDeployments, listFirewallRules, listMonitors, listNginxTemplates, listRecipes, listRedirectRules, listScheduledJobs, listSecurityRules, listServers, listServices, listSites, listSshKeys, rebootServer, resolveServers, resolveSites, restartDaemon, restartService, runRecipe, updateBackupConfig, updateDaemon, updateDatabaseUser, updateDeploymentScript, updateEnv, updateNginxConfig, updateNginxTemplate, updateRecipe, updateSecurityRule, updateSite } from "@studiometa/forge-core";
+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";
 //#region src/instructions.ts
 /**
 * MCP Server Instructions
@@ -153,6 +153,54 @@ function _getStandardProps(context) {
 	};
 }
 /**
+* Joins multiple `expects` values with the given separator.
+*
+* @param values The `expects` values.
+* @param separator The separator.
+*
+* @returns The joined `expects` property.
+*
+* @internal
+*/
+/* @__NO_SIDE_EFFECTS__ */
+function _joinExpects(values$1, separator) {
+	const list = [...new Set(values$1)];
+	if (list.length > 1) return `(${list.join(` ${separator} `)})`;
+	return list[0] ?? "never";
+}
+/* @__NO_SIDE_EFFECTS__ */
+function integer(message$1) {
+	return {
+		kind: "validation",
+		type: "integer",
+		reference: integer,
+		async: false,
+		expects: null,
+		requirement: Number.isInteger,
+		message: message$1,
+		"~run"(dataset, config$1) {
+			if (dataset.typed && !this.requirement(dataset.value)) _addIssue(this, "integer", dataset, config$1);
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
+function minValue(requirement, message$1) {
+	return {
+		kind: "validation",
+		type: "min_value",
+		reference: minValue,
+		async: false,
+		expects: `>=${requirement instanceof Date ? requirement.toJSON() : /* @__PURE__ */ _stringify(requirement)}`,
+		requirement,
+		message: message$1,
+		"~run"(dataset, config$1) {
+			if (dataset.typed && !(dataset.value >= this.requirement)) _addIssue(this, "value", dataset, config$1, { received: dataset.value instanceof Date ? dataset.value.toJSON() : /* @__PURE__ */ _stringify(dataset.value) });
+			return dataset;
+		}
+	};
+}
+/**
 * Returns the fallback value of the schema.
 *
 * @param schema The schema to get it from.
@@ -227,6 +275,45 @@ function array(item, message$1) {
 	};
 }
 /* @__NO_SIDE_EFFECTS__ */
+function boolean(message$1) {
+	return {
+		kind: "schema",
+		type: "boolean",
+		reference: boolean,
+		expects: "boolean",
+		async: false,
+		message: message$1,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps(this);
+		},
+		"~run"(dataset, config$1) {
+			if (typeof dataset.value === "boolean") dataset.typed = true;
+			else _addIssue(this, "type", dataset, config$1);
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
+function literal(literal_, message$1) {
+	return {
+		kind: "schema",
+		type: "literal",
+		reference: literal,
+		expects: /* @__PURE__ */ _stringify(literal_),
+		async: false,
+		literal: literal_,
+		message: message$1,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps(this);
+		},
+		"~run"(dataset, config$1) {
+			if (dataset.value === this.literal) dataset.typed = true;
+			else _addIssue(this, "type", dataset, config$1);
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
 function nullable(wrapped, default_) {
 	return {
 		kind: "schema",
@@ -361,6 +448,26 @@ function optional(wrapped, default_) {
 	};
 }
 /* @__NO_SIDE_EFFECTS__ */
+function picklist(options, message$1) {
+	return {
+		kind: "schema",
+		type: "picklist",
+		reference: picklist,
+		expects: /* @__PURE__ */ _joinExpects(options.map(_stringify), "|"),
+		async: false,
+		options,
+		message: message$1,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps(this);
+		},
+		"~run"(dataset, config$1) {
+			if (this.options.includes(dataset.value)) dataset.typed = true;
+			else _addIssue(this, "type", dataset, config$1);
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
 function string(message$1) {
 	return {
 		kind: "schema",
@@ -401,6 +508,96 @@ function unknown() {
 		}
 	};
 }
+/* @__NO_SIDE_EFFECTS__ */
+function variant(key, options, message$1) {
+	return {
+		kind: "schema",
+		type: "variant",
+		reference: variant,
+		expects: "Object",
+		async: false,
+		key,
+		options,
+		message: message$1,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps(this);
+		},
+		"~run"(dataset, config$1) {
+			const input = dataset.value;
+			if (input && typeof input === "object") {
+				let outputDataset;
+				let maxDiscriminatorPriority = 0;
+				let invalidDiscriminatorKey = this.key;
+				let expectedDiscriminators = [];
+				const parseOptions = (variant$1, allKeys) => {
+					for (const schema of variant$1.options) {
+						if (schema.type === "variant") parseOptions(schema, new Set(allKeys).add(schema.key));
+						else {
+							let keysAreValid = true;
+							let currentPriority = 0;
+							for (const currentKey of allKeys) {
+								const discriminatorSchema = schema.entries[currentKey];
+								if (currentKey in input ? discriminatorSchema["~run"]({
+									typed: false,
+									value: input[currentKey]
+								}, { abortEarly: true }).issues : discriminatorSchema.type !== "exact_optional" && discriminatorSchema.type !== "optional" && discriminatorSchema.type !== "nullish") {
+									keysAreValid = false;
+									if (invalidDiscriminatorKey !== currentKey && (maxDiscriminatorPriority < currentPriority || maxDiscriminatorPriority === currentPriority && currentKey in input && !(invalidDiscriminatorKey in input))) {
+										maxDiscriminatorPriority = currentPriority;
+										invalidDiscriminatorKey = currentKey;
+										expectedDiscriminators = [];
+									}
+									if (invalidDiscriminatorKey === currentKey) expectedDiscriminators.push(schema.entries[currentKey].expects);
+									break;
+								}
+								currentPriority++;
+							}
+							if (keysAreValid) {
+								const optionDataset = schema["~run"]({ value: input }, config$1);
+								if (!outputDataset || !outputDataset.typed && optionDataset.typed) outputDataset = optionDataset;
+							}
+						}
+						if (outputDataset && !outputDataset.issues) break;
+					}
+				};
+				parseOptions(this, /* @__PURE__ */ new Set([this.key]));
+				if (outputDataset) return outputDataset;
+				_addIssue(this, "type", dataset, config$1, {
+					input: input[invalidDiscriminatorKey],
+					expected: /* @__PURE__ */ _joinExpects(expectedDiscriminators, "|"),
+					path: [{
+						type: "object",
+						origin: "value",
+						input,
+						key: invalidDiscriminatorKey,
+						value: input[invalidDiscriminatorKey]
+					}]
+				});
+			} else _addIssue(this, "type", dataset, config$1);
+			return dataset;
+		}
+	};
+}
+/* @__NO_SIDE_EFFECTS__ */
+function pipe(...pipe$1) {
+	return {
+		...pipe$1[0],
+		pipe: pipe$1,
+		get "~standard"() {
+			return /* @__PURE__ */ _getStandardProps(this);
+		},
+		"~run"(dataset, config$1) {
+			for (const item of pipe$1) if (item.kind !== "metadata") {
+				if (dataset.issues && (item.kind === "schema" || item.kind === "transformation")) {
+					dataset.typed = false;
+					break;
+				}
+				if (!dataset.issues || !config$1.abortEarly && !config$1.abortPipeEarly) dataset = item["~run"](dataset, config$1);
+			}
+			return dataset;
+		}
+	};
+}
 /**
 * Parses an unknown input based on a schema.
 *
@@ -762,6 +959,20 @@ function formatServiceList(services) {
 	});
 	return `${services.length} service(s):\n${lines.join("\n")}`;
 }
+/**
+* Format a list of installed PHP versions.
+*/
+function formatPhpVersionList(versions) {
+	if (versions.length === 0) return "No PHP versions found.";
+	const lines = versions.map((v) => `• PHP ${v.version} (ID: ${v.id}) — ${v.status}`);
+	return `${versions.length} PHP version(s):\n${lines.join("\n")}`;
+}
+/**
+* Format a single PHP version.
+*/
+function formatPhpVersion(version) {
+	return `PHP ${version.version} (ID: ${version.id})\nBinary: ${version.binary_name}\nStatus: ${version.status}`;
+}
 //#endregion
 //#region src/errors.ts
 /**
@@ -1106,6 +1317,22 @@ var TOOLS = [{
 				enum: [...READ_ACTIONS],
 				description: "Read action to perform. Use \"help\" for resource documentation."
 			},
+			setting: {
+				type: "string",
+				description: "PHP setting to read (php get): version, config, max-upload-size, max-execution-time, opcache"
+			},
+			version: {
+				type: "string",
+				description: "PHP version ID or version (e.g. \"8.3\", \"php83\") for php get"
+			},
+			type: {
+				type: "string",
+				description: "PHP configuration file for php get setting=config: cli, fpm, pool"
+			},
+			user: {
+				type: "string",
+				description: "FPM pool user for php get setting=config type=pool (optional)"
+			},
 			operations: {
 				type: "array",
 				description: "Array of operations for batch execution (max 10). Each operation needs resource, action, and any additional params.",
@@ -1171,7 +1398,7 @@ var TOOLS = [{
 			},
 			type: {
 				type: "string",
-				description: "Resource type (e.g. app, web, worker for servers; mysql, postgres for databases; disk_usage, used_memory for monitors)"
+				description: "Resource type (e.g. app, web, worker for servers; mysql, postgres for databases; disk_usage, used_memory for monitors; cli, fpm, pool for php configs)"
 			},
 			domain: {
 				type: "string",
@@ -1183,7 +1410,7 @@ var TOOLS = [{
 			},
 			content: {
 				type: "string",
-				description: "Content body for env variables, nginx config, or deployment script updates"
+				description: "Content body for env variables, nginx config, deployment script or PHP config updates"
 			},
 			command: {
 				type: "string",
@@ -1191,7 +1418,7 @@ var TOOLS = [{
 			},
 			user: {
 				type: "string",
-				description: "Unix user to run as (daemons, scheduled jobs; e.g. forge, root)"
+				description: "Unix user to run as (daemons, scheduled jobs; e.g. forge, root), or the FPM pool user (php config type=pool)"
 			},
 			port: {
 				type: ["string", "number"],
@@ -1249,7 +1476,19 @@ var TOOLS = [{
 			},
 			version: {
 				type: "string",
-				description: "PHP version required when restarting the php service (e.g. php83)"
+				description: "PHP version: required when restarting the php service (e.g. php83); version ID or version (e.g. \"8.3\") for php update setting=config"
+			},
+			setting: {
+				type: "string",
+				description: "PHP setting to write (php update): config, max-upload-size, max-execution-time, opcache"
+			},
+			value: {
+				type: "number",
+				description: "Integer for php update: megabytes for max-upload-size, seconds for max-execution-time"
+			},
+			enabled: {
+				type: "boolean",
+				description: "For php update setting=opcache: true enables OPcache, false disables it"
 			}
 		},
 		required: ["resource", "action"]
@@ -2623,6 +2862,86 @@ var RESOURCE_HELP = {
 			}
 		]
 	},
+	php: {
+		description: "Manage PHP on a server: installed versions, cli/fpm/pool configuration files, max upload size, max execution time and OPcache",
+		scope: "server (requires server_id)",
+		actions: {
+			list: "List installed PHP versions (with their IDs)",
+			get: "Read one setting: version, config, max-upload-size, max-execution-time or opcache",
+			update: "Write one setting: config (replaces the whole file), max-upload-size, max-execution-time or opcache"
+		},
+		fields: {
+			setting: "What to read or write: version, config, max-upload-size, max-execution-time, opcache",
+			version: "PHP version ID, or a version such as \"8.3\", \"php83\" or \"php8.3\" (for setting=version and setting=config)",
+			type: "Configuration file for setting=config: cli, fpm or pool",
+			user: "Unix user of the FPM pool (optional, type=pool only)",
+			content: "Full configuration file content (update setting=config)",
+			value: "Integer for update: megabytes for max-upload-size, seconds for max-execution-time",
+			enabled: "Boolean for update setting=opcache: true enables, false disables"
+		},
+		examples: [
+			{
+				description: "List installed PHP versions",
+				params: {
+					resource: "php",
+					action: "list",
+					server_id: "123"
+				}
+			},
+			{
+				description: "Read the FPM php.ini of PHP 8.3",
+				params: {
+					resource: "php",
+					action: "get",
+					server_id: "123",
+					setting: "config",
+					version: "8.3",
+					type: "fpm"
+				}
+			},
+			{
+				description: "Replace the CLI php.ini of PHP 8.3",
+				params: {
+					resource: "php",
+					action: "update",
+					server_id: "123",
+					setting: "config",
+					version: "8.3",
+					type: "cli",
+					content: "memory_limit = 512M\n..."
+				}
+			},
+			{
+				description: "Set the max upload size to 128 MB",
+				params: {
+					resource: "php",
+					action: "update",
+					server_id: "123",
+					setting: "max-upload-size",
+					value: 128
+				}
+			},
+			{
+				description: "Read the OPcache status",
+				params: {
+					resource: "php",
+					action: "get",
+					server_id: "123",
+					setting: "opcache"
+				}
+			},
+			{
+				description: "Enable OPcache",
+				params: {
+					resource: "php",
+					action: "update",
+					server_id: "123",
+					setting: "opcache",
+					enabled: true
+				}
+			}
+		]
+	},
 	"firewall-rules": {
 		description: "Manage UFW firewall rules on a server",
 		scope: "server (requires server_id)",
@@ -3155,6 +3474,138 @@ var handleNginxTemplates = createResourceHandler({
 	}
 });
 //#endregion
+//#region src/handlers/php.ts
+var configFields = {
+	server_id: /* @__PURE__ */ string(),
+	setting: /* @__PURE__ */ literal("config"),
+	version: /* @__PURE__ */ string(),
+	type: /* @__PURE__ */ picklist(PHP_CONFIG_TYPES),
+	user: /* @__PURE__ */ optional(/* @__PURE__ */ string())
+};
+/**
+* Read one PHP setting. Scalar settings are wrapped in an object for JSON output.
+*/
+async function getPhpSetting(options, ctx) {
+	const { server_id } = options;
+	switch (options.setting) {
+		case "version": return getPhpVersion({
+			server_id,
+			version: options.version
+		}, ctx);
+		case "config": return getPhpConfig({
+			server_id,
+			version: options.version,
+			type: options.type,
+			user: options.user
+		}, ctx);
+		case "max-upload-size": return { data: { max_upload_size: (await getPhpMaxUploadSize({ server_id }, ctx)).data } };
+		case "max-execution-time": return { data: { max_execution_time: (await getPhpMaxExecutionTime({ server_id }, ctx)).data } };
+		default: return { data: { opcache_enabled: (await getPhpOpcache({ server_id }, ctx)).data } };
+	}
+}
+/**
+* Write one PHP setting.
+*/
+function updatePhpSetting(options, ctx) {
+	const { server_id } = options;
+	switch (options.setting) {
+		case "config": return updatePhpConfig({
+			server_id,
+			version: options.version,
+			type: options.type,
+			content: options.content,
+			user: options.user
+		}, ctx);
+		case "max-upload-size": return updatePhpMaxUploadSize({
+			server_id,
+			size: options.value
+		}, ctx);
+		case "max-execution-time": return updatePhpMaxExecutionTime({
+			server_id,
+			seconds: options.value
+		}, ctx);
+		default: return options.enabled ? enablePhpOpcache({ server_id }, ctx) : disablePhpOpcache({ server_id }, ctx);
+	}
+}
+/**
+* Format the result of a `get` for compact output.
+*/
+function formatGet(data, args) {
+	switch (args.setting) {
+		case "version": return formatPhpVersion(data);
+		case "config": return `PHP ${String(args.type)} configuration:\n${String(data)}`;
+		case "max-upload-size": return `PHP max upload size: ${data.max_upload_size} MB`;
+		case "max-execution-time": return `PHP max execution time: ${data.max_execution_time} seconds`;
+		default: return `OPcache is ${data.opcache_enabled ? "enabled" : "disabled"}.`;
+	}
+}
+/**
+* Format the confirmation of an `update`.
+*/
+function formatUpdate(args) {
+	switch (args.setting) {
+		case "config": return `PHP ${String(args.type)} configuration updated.`;
+		case "max-upload-size": return `PHP max upload size set to ${String(args.value)} MB.`;
+		case "max-execution-time": return `PHP max execution time set to ${String(args.value)} seconds.`;
+		default: return `OPcache ${args.enabled ? "enabled" : "disabled"}.`;
+	}
+}
+var handlePhp = createResourceHandler({
+	resource: "php",
+	actions: [
+		"list",
+		"get",
+		"update"
+	],
+	inputSchemas: {
+		list: /* @__PURE__ */ object({ server_id: /* @__PURE__ */ string() }),
+		get: /* @__PURE__ */ variant("setting", [
+			/* @__PURE__ */ object({
+				server_id: /* @__PURE__ */ string(),
+				setting: /* @__PURE__ */ literal("version"),
+				version: /* @__PURE__ */ string()
+			}),
+			/* @__PURE__ */ object(configFields),
+			/* @__PURE__ */ object({
+				server_id: /* @__PURE__ */ string(),
+				setting: /* @__PURE__ */ picklist([
+					"max-upload-size",
+					"max-execution-time",
+					"opcache"
+				])
+			})
+		]),
+		update: /* @__PURE__ */ variant("setting", [
+			/* @__PURE__ */ object({
+				...configFields,
+				content: /* @__PURE__ */ string()
+			}),
+			/* @__PURE__ */ object({
+				server_id: /* @__PURE__ */ string(),
+				setting: /* @__PURE__ */ picklist(["max-upload-size", "max-execution-time"]),
+				value: /* @__PURE__ */ pipe(/* @__PURE__ */ number(), /* @__PURE__ */ integer(), /* @__PURE__ */ minValue(0))
+			}),
+			/* @__PURE__ */ object({
+				server_id: /* @__PURE__ */ string(),
+				setting: /* @__PURE__ */ literal("opcache"),
+				enabled: /* @__PURE__ */ boolean()
+			})
+		])
+	},
+	executors: {
+		list: listPhpVersions,
+		get: getPhpSetting,
+		update: updatePhpSetting
+	},
+	formatResult: (action, data, args) => {
+		switch (action) {
+			case "list": return formatPhpVersionList(data);
+			case "get": return formatGet(data, args);
+			default: return formatUpdate(args);
+		}
+	}
+});
+//#endregion
 //#region src/handlers/recipes.ts
 var handleRecipes = createResourceHandler({
 	resource: "recipes",
@@ -3595,6 +4046,19 @@ var RESOURCE_SCHEMAS = {
 			restart: ["server_id", "service"]
 		}
 	},
+	php: {
+		actions: [
+			"list",
+			"get",
+			"update"
+		],
+		scope: "server",
+		required: {
+			list: ["server_id"],
+			get: ["server_id", "setting"],
+			update: ["server_id", "setting"]
+		}
+	},
 	"firewall-rules": {
 		actions: [
 			"list",
@@ -4501,6 +4965,7 @@ function routeToHandler(resource, 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);
+		case "php": return handlePhp(action, args, ctx);
 		case "user": return handleUser(action, args, ctx);
 		case "batch": return handleBatch(action, args, ctx, routeToHandler);
 		/* v8 ignore next 6 -- all valid resources are handled above; unreachable in practice */
@@ -4590,8 +5055,8 @@ async function executeToolWithCredentials(name, args, credentials) {
 }
 //#endregion
 //#region src/version.ts
-var VERSION = "0.4.6";
+var VERSION = "0.4.7";
 //#endregion
 export { INSTRUCTIONS as a, getTools as i, executeToolWithCredentials as n, STDIO_ONLY_TOOLS as r, VERSION as t };
 
-//# sourceMappingURL=version-BS77BDou.js.map
+//# sourceMappingURL=version-DAzDjx0T.js.map