{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://browser.local/schemas/lifecycle-action.schema.json",
  "title": "PluginLifecycleActionDeclaration",
  "type": "object",
  "required": ["version", "action", "mode"],
  "additionalProperties": false,
  "properties": {
    "version": { "const": 1 },
    "action": { "enum": ["install", "start", "stop", "restart", "status"] },
    "mode": { "enum": ["oneshot", "supervised", "control"] },
    "executableKey": { "$ref": "game-plugin.manifest.schema.json#/$defs/relativePathRef" },
    "targetExecutableKey": { "$ref": "game-plugin.manifest.schema.json#/$defs/relativePathRef" },
    "arguments": {
      "type": "array",
      "items": { "type": "string", "minLength": 1, "maxLength": 240 },
      "maxItems": 64
    },
    "environment": {
      "type": "object",
      "propertyNames": { "pattern": "^(GAME|SERVER|RUN)_[A-Z0-9_]{1,59}$" },
      "additionalProperties": { "type": "string", "maxLength": 512 },
      "maxProperties": 32
    },
    "outputMode": { "enum": ["pipes", "console"] },
    "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 7200000 },
    "stopTimeoutMs": { "type": "integer", "minimum": 1, "maximum": 60000 },
    "gracefulStop": {
      "type": "object",
      "required": ["executableKey"],
      "additionalProperties": false,
      "properties": {
        "executableKey": { "$ref": "game-plugin.manifest.schema.json#/$defs/relativePathRef" },
        "arguments": {
          "type": "array",
          "items": { "type": "string", "minLength": 1, "maxLength": 240 },
          "maxItems": 64
        },
        "environment": {
          "type": "object",
          "propertyNames": { "pattern": "^(GAME|SERVER|RUN)_[A-Z0-9_]{1,59}$" },
          "additionalProperties": { "type": "string", "maxLength": 512 },
          "maxProperties": 32
        },
        "timeoutMs": { "type": "integer", "minimum": 1, "maximum": 1800000 },
        "fallback": { "enum": ["report", "terminate"] }
      }
    }
  }
}