plugin-manifest.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/Lithe-IDEA/Lithe-core-rust/main/shared/plugins/contract/v1/plugin-manifest.schema.json",
  "title": "Lithe declarative plugin manifest (plugin contract v1)",
  "description": "Shape of plugin.json for a declarative plugin. Semantic rules that JSON Schema cannot express (cross references, permissions, activation events, template variables) are defined in README.md and enforced by plugins.declarative.validate.",
  "type": "object",
  "additionalProperties": false,
  "required": ["schemaVersion", "id", "displayName", "version", "pluginAPIVersion", "requires", "vendor"],
  "allOf": [
    {"if": {"required": ["outputLinkMatchers"]}, "then": {"properties": {"requires": {"required": ["outputLinkMatchers"]}}}},
    {"if": {"required": ["toolDefinitions"]}, "then": {"properties": {"requires": {"required": ["toolDefinitions"]}}}},
    {"if": {"required": ["toolchainProviders"]}, "then": {"required": ["backend"], "properties": {"requires": {"required": ["toolchainProviders", "backend"]}, "permissions": {"allOf": [{"contains": {"const": "toolchains.provide"}}, {"contains": {"const": "backend.launch"}}]}}}},
    {"if": {"required": ["pluginFunctions"]}, "then": {"required": ["backend"], "properties": {"requires": {"required": ["pluginFunctions", "backend"]}}}},
    {"if": {"required": ["keymapImportProviders"]}, "then": {"required": ["backend", "permissions"], "properties": {"requires": {"required": ["keymapImportProviders", "backend"]}, "permissions": {"allOf": [{"contains": {"const": "keymaps.provide"}}, {"contains": {"const": "keymaps.readSelectedSources"}}, {"contains": {"const": "backend.launch"}}]}}}},
    {"if": {"required": ["languageServers"], "properties": {"languageServers": {"contains": {"required": ["launch"], "properties": {"launch": {"required": ["kind"], "properties": {"kind": {"const": "backend"}}}}}}}}, "then": {"required": ["backend"], "properties": {"requires": {"required": ["backend"]}}}}
  ],
  "properties": {
    "schemaVersion": { "const": 0 },
    "id": { "type": "string", "pattern": "^[a-z0-9.-]+$" },
    "displayName": { "type": "string", "minLength": 1 },
    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
    "pluginAPIVersion": { "description": "Plugin API version of the manifest format. Always 0 in this contract; a host refuses any other value with plugin.api.unsupported.", "const": 0 },
    "requires": {
      "description": "Required: every capability the manifest uses, each with the version of that capability's contract it was written against. Every capability defines only version 0 today. Listing a capability the manifest does not use, or leaving out one it uses, is refused.",
      "type": "object",
      "minProperties": 1,
      "additionalProperties": false,
      "properties": {
        "backend": { "description": "Required exactly when backend is present: the plugin's own process. It serves its web pages, may also start on onWorkspaceOpen or a plugin command, receives workspace contexts through the litheFunctions protocol, and may be granted workspace.metadata.", "enum": [0] },
        "buildModelInputs": {"description": "Optional public model sharing between already enabled workspace plugins; no installation, private function, or process authority. Required exactly when modelSharing or modelInputs is used. Consumers require buildProviders. A producer cannot also consume inputs.", "enum": [0]},
        "buildProviders": { "description": "Required exactly when any buildSystems[].provider is present, including own-process and shared language-server providers. Declares host support for Provider orchestration (task execution, test execution and discovery, run preparation, native debug preparation, optional read-only model inputs, non-sensitive native configuration sources, inline test reports, opaque semantic test selectors, typed run options and service/task preparation, registry-selected adapters and host-owned connection targets for service debugging), independent of declarative buildSystems.", "enum": [0] },
        "buildSystems": { "description": "Declarative build detection, models, and command plans, including the executable setting adapter, instance-scoped options, and declarative preparation roles; does not imply buildProviders support.", "enum": [0] },
        "debugAdapters": { "description": "Required exactly when debugAdapters is non-empty. Covers bounded target argument and environment bindings and debugAdapters[].features and defaults. The DAP session itself is negotiated by the adapter in initialize.", "enum": [0] },
        "executionProviders": { "enum": [0] },
        "languageServers": { "description": "Required exactly when languageServers is non-empty. Covers languageServers[].workspaceConfiguration and the session fields requestMethods, commands, serializedCommands, forwardNotifications, state, and remote.", "enum": [0] },
        "languages": { "description": "Required exactly when languages is non-empty. Covers languages[].grammar, a TextMate grammar, and languages[].configuration.", "enum": [0] },
        "outputLinkMatchers": { "description": "Required exactly when outputLinkMatchers is non-empty.", "enum": [0] },
        "packageTrust": { "description": "Required exactly when vendor.bundledSignatureRequirement is present.", "enum": [0] },
        "projectGenerators": { "description": "Entries of the New Project window: fields, requirements, and steps, with tool fields that pick tool installations.", "enum": [0] },
        "settings": { "description": "Required exactly when settings or settingActions is non-empty. Covers integer, enum, boolean, multiSelect, text, file, and directory options, scope, effect, page, section, and settingActions.", "enum": [0] },
        "toolDefinitions": { "enum": [0] },
        "toolchainProviders": { "enum": [0] },
        "keymapImportProviders": { "enum": [0] },
        "pluginFunctions": { "description": "Required exactly when pluginFunctions is present: functions this plugin's backend exports to other plugins, and exported functions it calls. Needs backend.", "enum": [0] },
        "ui": { "description": "Required exactly when ui is present. Covers tool windows with text, web content, and native controls, and backend-only commands.", "enum": [0] },
        "vcsProviders": { "description": "Required exactly when vcsProviders is non-empty. The provider protocol itself is negotiated in initialize (https://github.com/Lithe-IDEA/Lithe-core-rust/blob/main/rust/contracts/vcs-provider-v1.md).", "enum": [0] }
      }
    },
    "vendor": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "displayName", "signatureRequirement"],
      "properties": {
        "id": { "type": "string", "minLength": 1 },
        "displayName": { "type": "string", "minLength": 1 },
        "signatureRequirement": { "enum": ["sameTeamAsHost", "publisherPackage", "none"] },
        "bundledSignatureRequirement": {
          "description": "requires.packageTrust: host-pinned official packages may trust the host's sealed bundled copy; all other origins require publisherPackage.",
          "const": "sameTeamAsHost"
        }
      }
    },
    "permissions": {
      "type": "array",
      "items": { "enum": ["backend.launch", "credentials.store", "debug.attach", "debug.launch", "languageServer.launch", "process.build", "process.run", "process.test", "process.vcs", "project.generate", "ui.contribute", "ui.web", "workspace.metadata",
          "workspace.files.read",
          "workspace.files.watch",
          "workspace.search",
          "documents.read",
          "editor.edit",
          "editor.actions",
          "editor.providers",
          "editor.open",
          "preview.open",
          "toolchains.provide",
          "keymaps.provide",
          "keymaps.readSelectedSources",
          "browser.open",
          "window.messages",
          "terminal.create",
          "run.start",
          "debug.start",
          "languageServer.request",
          "documents.contentProvider"] }
    },
    "activationEvents": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "onWorkspaceOpen names no ID and needs requires.backend; it starts the backend once a workspace is open.",
        "pattern": "^((onLanguage|onRun|onTest|onView|onCommand|onBuildSystem|onVcsRoot|onDebug):[a-z0-9.+_-]+|onWorkspaceOpen)$"
      }
    },
    "toolDefinitions": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/toolchainToolDefinition" } },
    "requiresTools": {
      "description": "Every tool definition the plugin starts or names, by ID. A runtime tool of a launch, a runtime dependency, a runSelectedRuntime tool, or the tool of a lithe/host/run/start must be listed here. An ID is short or <pluginID>:<id>; a short ID defined by more than one enabled plugin belongs to none of them.",
      "type": "array",
      "minItems": 1,
      "maxItems": 32,
      "uniqueItems": true,
      "items": { "$ref": "#/$defs/toolchainToolID" }
    },
    "outputLinkMatchers": {
      "description": "requires.outputLinkMatchers: patterns that turn Run and Test console text into links.",
      "type": "array",
      "minItems": 1,
      "maxItems": 16,
      "items": { "$ref": "#/$defs/outputLinkMatcher" }
    },
    "toolchainProviders": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "$ref": "#/$defs/toolchainProvider" } },
    "keymapImportProviders": { "type": "array", "minItems": 1, "maxItems": 8, "items": { "$ref": "#/$defs/keymapImportProvider" } },
    "pluginFunctions": { "$ref": "#/$defs/pluginFunctions" },
    "languages": {
      "type": "array",
      "minItems": 0,
      "items": { "$ref": "#/$defs/language" }
    },
    "languageServers": {
      "type": "array",
      "items": { "$ref": "#/$defs/languageServer" }
    },
    "executionProviders": {
      "type": "array",
      "items": { "$ref": "#/$defs/executionProvider" }
    },
    "buildSystems": {
      "description": "requires.buildSystems: build systems Core detects, models, and plans commands for. Requires process.build and one onBuildSystem:<id> activation event per build system.",
      "type": "array",
      "maxItems": 16,
      "items": { "$ref": "#/$defs/buildSystem" }
    },
    "backend": {
      "description": "requires.backend: the plugin's own LSP base-protocol process. The host keeps one process per plugin on the machine that runs Lithe, independent of any workspace, and ends it when the plugin is disabled, updated, or uninstalled. It starts on the first plugin-function call from one of the plugin's web pages, on onWorkspaceOpen, or on one of the plugin's commands, and the manifest declares at least one of those. Requires backend.launch; credentials.store lets it use the host's private credential store; workspace.metadata lets it list workspace contexts.",
      "$ref": "#/$defs/backend"
    },
    "vcsProviders": {
      "description": "requires.vcsProviders: version control systems the plugin provides, each through its own LSP base-protocol process. Requires languageServer.launch, process.vcs, and one onVcsRoot:<id> activation event per provider.",
      "type": "array",
      "maxItems": 8,
      "items": { "$ref": "#/$defs/vcsProvider" }
    },
    "debugAdapters": {
      "description": "requires.debugAdapters: debug adapters the plugin implements, each started as its own DAP process, or hosted by the plugin's own language server (transport tcpLanguageServer). Requires debug.launch (and debug.attach when an adapter serves attach) and one onDebug:<id> activation event per adapter.",
      "type": "array",
      "maxItems": 16,
      "items": { "$ref": "#/$defs/debugAdapter" }
    },
    "projectGenerators": {
      "description": "requires.projectGenerators: entries of the New Project window. Requires the project.generate permission.",
      "type": "array",
      "maxItems": 16,
      "items": { "$ref": "#/$defs/projectGenerator" }
    },
    "ui": {
      "type": "object",
      "additionalProperties": false,
      "description": "requires.ui: tool windows and commands. A command may be backend-only, without toolWindowID or tool windows.",
      "properties": {
        "toolWindows": {
          "type": "array",
          "minItems": 0,
          "maxItems": 64,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "title",
              "placement"
            ],
            "oneOf": [
              { "required": ["text"] },
              { "required": ["web"] },
              { "required": ["native"] }
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z0-9.-]+$"
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256
              },
              "placement": {
                "enum": [
                  "left",
                  "bottom",
                  "right"
                ]
              },
              "order": {
                "type": "integer"
              },
              "text": {
                "type": "string",
                "maxLength": 65536
              },
              "native": { "$ref": "native-ui.schema.json" },
              "web": {
                "description": "The plugin's own page, served from the package into a sandboxed host web view. Needs the ui.web permission.",
                "type": "object",
                "additionalProperties": false,
                "required": ["entry"],
                "properties": {
                  "entry": {
                    "description": "Package-relative path of the HTML entry page.",
                    "type": "string",
                    "maxLength": 256,
                    "pattern": "^(?!/)(?!.*(^|/)\\.{1,2}(/|$))[^:\\\\]+\\.html$"
                  }
                }
              },
              "icon": {
                "$ref": "#/$defs/uiIcon"
              }
            }
          }
        },
        "commands": {
          "type": "array",
          "maxItems": 128,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "title",
              "placements"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z0-9.-]+$"
              },
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 256
              },
              "toolWindowID": {
                "type": "string",
                "pattern": "^[a-z0-9.-]+$"
              },
              "order": {
                "type": "integer"
              },
              "placements": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "enum": [
                    "commandPalette",
                    "toolbar",
                    "menu"
                  ]
                }
              },
              "icon": {
                "$ref": "#/$defs/uiIcon"
              }
            }
          }
        }
      }
    },
    "settings": {
      "description": "requires.settings: user-adjustable options with unique IDs.",
      "type": "array",
      "maxItems": 32,
      "items": { "$ref": "#/$defs/setting" }
    },
    "settingActions": {
      "description": "requires.settings: buttons on settings pages that invoke the plugin's own functions, with unique IDs.",
      "type": "array",
      "maxItems": 16,
      "items": { "$ref": "#/$defs/settingAction" }
    }
  },
  "$defs": {
    "pluginFunctionID": {
      "description": "Dot-separated lowerCamelCase segments, for example document.format.",
      "type": "string",
      "maxLength": 128,
      "pattern": "^[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$"
    },
    "pluginFunctions": {
      "description": "Functions this plugin exports to other plugins and exported functions it calls. A function is private to its plugin unless it is exported here and registered at runtime with lithe/function/register; calling it takes no permission, because the receiver's export and the caller's declaration are the consent. The called function runs with the receiver's own permissions.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "exports": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/pluginFunctionExport" } },
        "calls": { "type": "array", "minItems": 1, "maxItems": 32, "items": { "$ref": "#/$defs/pluginFunctionCall" } }
      }
    },
    "pluginFunctionExport": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "version", "context"],
      "properties": {
        "id": { "$ref": "#/$defs/pluginFunctionID" },
        "version": { "description": "Version of the function's input and result contract; an incompatible change uses a new version.", "type": "integer", "minimum": 1, "maximum": 1000 },
        "context": { "description": "The one calling context the function accepts. workspace: a local trusted workspace, scheduled by the host. An export without a context Lithe knows is refused.", "enum": ["workspace"] }
      }
    },
    "pluginFunctionCall": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "version"],
      "properties": {
        "id": { "$ref": "#/$defs/pluginFunctionID" },
        "version": { "description": "The export contract version this plugin was written for; Core refuses a provider that exports another version.", "type": "integer", "minimum": 1, "maximum": 1000 }
      }
    },
    "keymapImportProvider": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "displayName", "recognition", "inputs"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$" },
        "displayName": { "type": "string", "minLength": 1, "maxLength": 64, "pattern": "^[^\\u0000-\\u001f\\u007f]+$" },
        "recognition": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true,
          "items": { "$ref": "#/$defs/keymapImportRecognition" } },
        "inputs": { "type": "array", "minItems": 1, "maxItems": 16, "uniqueItems": true,
          "items": { "$ref": "#/$defs/keymapImportInput" } }
      }
    },
    "keymapImportRecognition": {
      "oneOf": [
        { "type": "object", "additionalProperties": false, "required": ["kind", "path"],
          "properties": { "kind": { "enum": ["file", "directory"] }, "path": { "$ref": "#/$defs/keymapImportInput/properties/path" } } },
        { "type": "object", "additionalProperties": false, "required": ["kind", "base", "components"],
          "properties": { "kind": { "const": "root" }, "base": { "const": "userConfig" },
            "components": { "type": "array", "minItems": 1, "maxItems": 8,
              "contains": { "const": "*" }, "minContains": 0, "maxContains": 1,
              "items": { "type": "string", "maxLength": 256, "pattern": "^(?:\\*|(?!.*[. ]$)[^/\\\\:*?\\u0000-\\u001f\\u007f]+)$" } } } }
      ]
    },
    "keymapImportInput": {
      "type": "object", "additionalProperties": false, "required": ["kind", "path"],
      "properties": {
        "kind": { "enum": ["file", "directory"] },
        "path": { "type": "string", "minLength": 1, "maxLength": 256,
          "pattern": "^(?!/)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*(?:^|/)[^/]*[. ](?:/|$))[^/\\\\:*?\\u0000-\\u001f\\u007f]+(?:/[^/\\\\:*?\\u0000-\\u001f\\u007f]+)*$" },
        "extension": { "type": "string", "pattern": "^[a-z0-9]{1,16}$" }
      },
      "allOf": [
        { "if": { "properties": { "kind": { "const": "directory" } } }, "then": { "required": ["extension"] } },
        { "if": { "properties": { "kind": { "const": "file" } } }, "then": { "not": { "required": ["extension"] } } }
      ]
    },
    "debugLocalID": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9._-]{0,63}$"
    },
    "debugPackagePath": {
      "description": "Read-only package-relative path. Core must additionally reject escaping symlinks and platform-specific path escapes.",
      "type": "string",
      "minLength": 1,
      "pattern": "^(?!/)(?!.*(?:^|/)[.]{1,2}(?:/|$))[^\\\\:\\u0000]+$"
    },
    "debugArgumentName": {
      "description": "One DAP argument name or object key.",
      "type": "string",
      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}$"
    },
    "debugArgumentPath": {
      "description": "Dotted path to a DAP argument, up to four names, for example `hostName` or `connect.host`. Objects on the way are created; the path must not overlap another binding or an argument the configuration sets itself.",
      "type": "string",
      "pattern": "^[A-Za-z_][A-Za-z0-9_-]{0,63}(\\.[A-Za-z_][A-Za-z0-9_-]{0,63}){0,3}$"
    },
    "debugConnectionBinding": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "host": {
          "description": "Receives `target.host`, a string. Declared together with `port`.",
          "$ref": "#/$defs/debugArgumentPath"
        },
        "port": {
          "description": "Receives `target.port`, an integer 1-65535. Declared together with `host`.",
          "$ref": "#/$defs/debugArgumentPath"
        },
        "address": {
          "description": "Receives `host:port` as one string; an IPv6 host is written in brackets.",
          "$ref": "#/$defs/debugArgumentPath"
        },
        "pathMappings": {
          "description": "How local and remote source roots reach the adapter. Omit when the adapter takes none; the host then does not offer the choice.",
          "oneOf": [
            {
              "description": "A list of objects at `argument`, each with the local root under `localKey` and the remote root under `remoteKey`.",
              "type": "object",
              "additionalProperties": false,
              "required": ["shape", "argument", "localKey", "remoteKey"],
              "properties": {
                "shape": { "const": "objects" },
                "argument": { "$ref": "#/$defs/debugArgumentPath" },
                "localKey": { "$ref": "#/$defs/debugArgumentName" },
                "remoteKey": { "$ref": "#/$defs/debugArgumentName" }
              }
            },
            {
              "description": "The first mapping only, as two strings at `local` and `remote`.",
              "type": "object",
              "additionalProperties": false,
              "required": ["shape", "local", "remote"],
              "properties": {
                "shape": { "const": "first" },
                "local": { "$ref": "#/$defs/debugArgumentPath" },
                "remote": { "$ref": "#/$defs/debugArgumentPath" }
              }
            },
            {
              "description": "An object at `argument` with one root as the key and the other as the value, keyed by the `keyedBy` side. A target with the same root twice on that side is refused.",
              "type": "object",
              "additionalProperties": false,
              "required": ["shape", "argument", "keyedBy"],
              "properties": {
                "shape": { "const": "dictionary" },
                "argument": { "$ref": "#/$defs/debugArgumentPath" },
                "keyedBy": { "enum": ["local", "remote"] }
              }
            },
            {
              "description": "A list of two-element arrays at `argument`, the roots in the given `order`.",
              "type": "object",
              "additionalProperties": false,
              "required": ["shape", "argument", "order"],
              "properties": {
                "shape": { "const": "pairs" },
                "argument": { "$ref": "#/$defs/debugArgumentPath" },
                "order": { "enum": ["remoteLocal", "localRemote"] }
              }
            }
          ]
        }
      },
      "dependentRequired": {
        "host": ["port"],
        "port": ["host"]
      },
      "anyOf": [
        { "required": ["host"] },
        { "required": ["address"] }
      ]
    },
    "debugServerProcess": {
      "$ref": "#/$defs/processLaunch",
      "description": "Reuse existing launch fields and validation. LSP initializationOptions have no meaning for a DAP transport and are excluded.",
      "propertyNames": {
        "enum": [
          "launch",
          "arguments",
          "validationArguments",
          "runtimeDependencies"
        ]
      },
      "unevaluatedProperties": false
    },
    "debugRunSelectedRuntimeProcess": {
      "description": "Resolve through Run's selected runtime for this target, not a plugin dependency or a separate Debug runtime preference.",
      "type": "object",
      "additionalProperties": false,
      "required": [
        "launch"
      ],
      "properties": {
        "launch": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "tool"
          ],
          "properties": {
            "kind": {
              "const": "runSelectedRuntime"
            },
            "tool": {
              "description": "The ID of a tool definition listed in requiresTools.",
              "$ref": "#/$defs/toolchainToolID"
            }
          }
        },
        "arguments": {
          "$ref": "#/$defs/processLaunch/properties/arguments"
        },
        "validationArguments": {
          "$ref": "#/$defs/processLaunch/properties/validationArguments"
        }
      }
    },
    "debugProcess": {
      "oneOf": [
        {
          "$ref": "#/$defs/debugServerProcess"
        },
        {
          "$ref": "#/$defs/debugRunSelectedRuntimeProcess"
        }
      ]
    },
    "debugLaunch": {
      "type": "object",
      "required": [
        "transport"
      ],
      "properties": {
        "process": {
          "$ref": "#/$defs/debugProcess"
        }
      },
      "oneOf": [
        {
          "required": [
            "process"
          ],
          "properties": {
            "transport": {
              "const": "stdio"
            }
          }
        },
        {
          "required": [
            "process",
            "endpoint"
          ],
          "properties": {
            "transport": {
              "const": "tcpAnnounced"
            },
            "endpoint": {
              "description": "A bounded line decoder, not an executable-name-specific format or a regex engine. Only loopback endpoints are accepted.",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "stream",
                "prefix",
                "value"
              ],
              "properties": {
                "stream": {
                  "enum": [
                    "stdout",
                    "stderr"
                  ]
                },
                "prefix": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 256,
                  "pattern": "^[^\\r\\n]+$"
                },
                "value": {
                  "enum": [
                    "port",
                    "hostPort"
                  ]
                }
              }
            }
          }
        },
        {
          "required": [
            "process",
            "endpoint"
          ],
          "properties": {
            "transport": {
              "const": "tcpPort"
            },
            "endpoint": {
              "description": "A fixed loopback port for this adapter process, not the debuggee's attach port. Conflicts fail explicitly; no automatic port substitution.",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "port"
              ],
              "properties": {
                "port": {
                  "type": "integer",
                  "minimum": 1,
                  "maximum": 65535
                }
              }
            }
          }
        },
        {
          "required": [
            "endpoint"
          ],
          "not": {
            "required": [
              "process"
            ]
          },
          "properties": {
            "transport": {
              "const": "tcpLanguageServer"
            },
            "endpoint": {
              "description": "The adapter runs inside a language server this plugin declares in languageServers, which has no adapter process of its own. The host starts that server, sends workspace/executeCommand with command, and connects to the loopback port the server answers with (an integer or a numeric string).",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "languageID",
                "command"
              ],
              "properties": {
                "languageID": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 64,
                  "pattern": "^[a-z0-9+_-]+$"
                },
                "command": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 128,
                  "pattern": "^[A-Za-z0-9._:-]+$"
                }
              }
            }
          }
        }
      ],
      "unevaluatedProperties": false
    },
    "debugSelector": {
      "description": "Optional automatic matching: OR between selectors, AND between fields. Omission means explicit selection only, not a wildcard registration.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "targetKinds": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "enum": [
              "file",
              "executable",
              "runTarget",
              "process",
              "connection"
            ]
          }
        },
        "languageIDs": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9+_-]+$"
          }
        }
      }
    },
    "debugConfiguration": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "arguments": {
          "description": "Adapter-owned default DAP arguments. Ordinary JSON data; no embedded references, expressions or resource handles are interpreted.",
          "type": "object"
        },
        "parametersSchema": {
          "description": "Optional packaged schema for final merged DAP arguments, with local read-only refs only. Not a new Debug configuration file.",
          "$ref": "#/$defs/debugPackagePath"
        },
        "targetBindings": {
          "description": "Typed projections into known DAP fields. They only fill missing arguments; explicit values retain their existing precedence.",
          "type": "object",
          "additionalProperties": false,
          "minProperties": 1,
          "properties": {
            "program": {
              "description": "`target.path` is the target's own path. `target.executable` is the program the host found through `executable`, which then must be declared.",
              "enum": ["target.path", "target.executable"]
            },
            "processId": {
              "const": "target.processID"
            },
            "cwd": {
              "const": "target.workingDirectory"
            },
            "args": { "const": "target.arguments" },
            "env": { "const": "target.environment" },
            "connection": {
              "description": "Attach only. Where the remote target's host and port go. Unlike the other bindings, each value is the destination argument path, because adapters name and nest these differently.",
              "$ref": "#/$defs/debugConnectionBinding"
            }
          }
        },
        "executable": {
          "description": "Launch only. Where a host finds the program a source file builds into: the user's `file` setting first, then the candidates. Required exactly when `targetBindings.program` is `target.executable`.",
          "type": "object",
          "additionalProperties": false,
          "required": ["setting"],
          "properties": {
            "setting": {
              "description": "ID of a `file` setting of the same plugin.",
              "type": "string",
              "minLength": 1
            },
            "candidates": {
              "description": "Paths tried in order when the setting is empty. Each starts with `${workspaceFolder}/` or `${fileDirectory}/` and may use `${fileBasenameNoExtension}`; no `..`.",
              "type": "array",
              "maxItems": 8,
              "uniqueItems": true,
              "items": {
                "type": "string",
                "maxLength": 1024,
                "pattern": "^\\$\\{(workspaceFolder|fileDirectory)\\}/"
              }
            }
          }
        }
      }
    },
    "debugCapabilities": {
      "description": "Optional suppression only. Disabled entries are standard DAP initialize capability names plus exceptionBreakpointFilters. Omission follows DAP; true values and function implementations are not accepted.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "disabled": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "pattern": "^(supports[A-Z][A-Za-z0-9]*|exceptionBreakpointFilters)$"
          }
        }
      }
    },
    "debugConsole": {
      "description": "Debugger commands the adapter's console understands, offered as completions while typing in the Debug Console. Adapters that answer the DAP completions request complete live; this list is for the ones that do not. Names are inserted as written; Core refuses padded or duplicate names.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "commandPrefix": {
          "description": "Text the adapter's console reads as \"what follows is a debugger command\". The host puts it before the typed line when it asks the adapter to complete, so the adapter proposes commands instead of expression keywords. No spaces.",
          "type": "string",
          "minLength": 1,
          "maxLength": 8,
          "pattern": "^\\S+$"
        },
        "commands": {
          "type": "array",
          "minItems": 1,
          "maxItems": 1024,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "minLength": 1,
                "maxLength": 128
              },
              "description": {
                "description": "One line shown beside the name, as written. Not translated by the host.",
                "type": "string",
                "minLength": 1,
                "maxLength": 240
              }
            }
          }
        }
      }
    },
    "debugAdapter": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "displayName",
        "launch"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/debugLocalID"
        },
        "displayName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "adapterID": {
          "description": "DAP initialize adapterID. Defaults to the local adapter id; never substitutes for the qualified Registry identity.",
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "requests": {
          "description": "Defaults to launch only. Attach must be explicitly declared and separately authorized.",
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "enum": [
              "launch",
              "attach"
            ]
          },
          "default": [
            "launch"
          ]
        },
        "selectors": {
          "type": "array",
          "minItems": 1,
          "items": {
            "$ref": "#/$defs/debugSelector"
          }
        },
        "configurationTypes": {
          "description": "Optional imported launch.json type aliases. Ambiguity requires selection; aliases do not override another provider.",
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "minLength": 1
          }
        },
        "configurations": {
          "type": "object",
          "additionalProperties": false,
          "minProperties": 1,
          "properties": {
            "launch": {
              "$ref": "#/$defs/debugConfiguration"
            },
            "attach": {
              "$ref": "#/$defs/debugConfiguration"
            }
          }
        },
        "capabilities": {
          "$ref": "#/$defs/debugCapabilities"
        },
        "console": {
          "$ref": "#/$defs/debugConsole"
        },
        "launch": {
          "$ref": "#/$defs/debugLaunch"
        },
        "features": {
          "description": "Adapter-specific DAP extensions the adapter implements.",
          "$ref": "#/$defs/debugAdapterFeatures"
        },
        "defaults": {
          "description": "Values the adapter starts with when the user configured none.",
          "$ref": "#/$defs/debugAdapterDefaults"
        }
      }
    },
    "debugDeclaredName": {
      "description": "A DAP command, event, field or argument name: a letter followed by up to 63 letters, digits, dots, underscores or hyphens.",
      "type": "string",
      "pattern": "^[A-Za-z][A-Za-z0-9._-]{0,63}$"
    },
    "debugAdapterFeatures": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "hotCodeReplace": {
          "description": "A custom request that applies changed code to the running debuggee.",
          "type": "object",
          "additionalProperties": false,
          "required": ["request"],
          "properties": {
            "request": { "description": "DAP command sent for a redefineClasses inspection.", "$ref": "#/$defs/debugDeclaredName" },
            "event": { "description": "DAP event whose message the Debug Console shows as progress.", "$ref": "#/$defs/debugDeclaredName" },
            "changedField": { "description": "Response body field listing the replaced units.", "$ref": "#/$defs/debugDeclaredName" },
            "errorField": { "description": "Response body field with a failure message the adapter reports in a successful response.", "$ref": "#/$defs/debugDeclaredName" }
          }
        },
        "stepFilters": {
          "description": "The launch argument through which the adapter receives {skipClasses, skipSynthetics, skipStaticInitializers, skipConstructors}.",
          "type": "object",
          "additionalProperties": false,
          "required": ["argument"],
          "properties": {
            "argument": { "$ref": "#/$defs/debugDeclaredName" }
          }
        }
      }
    },
    "debugAdapterDefaults": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "stepFilters": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "classNameFilters": {
              "type": "array",
              "maxItems": 256,
              "items": { "type": "string", "minLength": 1, "maxLength": 256 }
            },
            "skipSynthetics": { "type": "boolean" },
            "skipStaticInitializers": { "type": "boolean" },
            "skipConstructors": { "type": "boolean" },
            "hideFilteredStackFrames": { "type": "boolean" }
          }
        }
      }
    },
    "outputLinkMatcher": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "pattern"],
      "properties": {
        "id": { "description": "Plugin-local ID, unique in the plugin.", "type": "string", "pattern": "^[a-z][a-z0-9._-]{0,63}$" },
        "pattern": {
          "description": "A Rust regex matched against one console line. Without resolve it captures path and may capture line and column; it must not match empty text.",
          "type": "string",
          "minLength": 1,
          "maxLength": 512
        },
        "scope": { "description": "The console the matcher applies to; both when absent.", "enum": ["run", "test"] },
        "resolve": {
          "description": "A function of the plugin's backend process that turns the named groups into a location.",
          "type": "object",
          "additionalProperties": false,
          "required": ["function"],
          "properties": {
            "function": { "type": "string", "minLength": 1 }
          }
        }
      }
    },
    "generatorCondition": {
      "type": "object",
      "additionalProperties": false,
      "required": ["field"],
      "properties": {
        "field": { "type": "string", "description": "A field declared earlier in the same generator." },
        "equals": { "type": ["string", "boolean"] },
        "notEquals": { "type": ["string", "boolean"] },
        "oneOf": { "type": "array", "minItems": 1, "items": { "type": ["string", "boolean"] } }
      },
      "oneOf": [
        { "required": ["equals"] },
        { "required": ["notEquals"] },
        { "required": ["oneOf"] }
      ]
    },
    "generatorConditions": {
      "oneOf": [
        { "$ref": "#/$defs/generatorCondition" },
        { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/generatorCondition" } }
      ]
    },
    "generatorField": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z][A-Za-z0-9]*$" },
        "type": { "enum": ["text", "enum", "boolean", "multiSelect", "tool"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "minLength": 1, "maxLength": 480 },
        "advanced": { "type": "boolean" },
        "visibleWhen": { "$ref": "#/$defs/generatorConditions" },
        "default": { "description": "text: a template over ${project.name} and earlier fields; enum: an option; boolean; multiSelect: options. Not allowed for tool." },
        "options": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["value", "title"],
            "properties": {
              "value": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,120}$" },
              "title": { "type": "string", "minLength": 1, "maxLength": 120 },
              "group": { "type": "string", "minLength": 1, "maxLength": 120 }
            }
          }
        },
        "presentation": { "enum": ["segmented", "menu"] },
        "pattern": { "type": "string", "maxLength": 256 },
        "maxLength": { "type": "integer", "minimum": 1, "maximum": 1024 },
        "placeholder": { "type": "string", "minLength": 1, "maxLength": 120 },
        "optional": { "type": "boolean" },
        "tool": {
          "description": "tool: a tool definition ID, a short ID or <pluginID>:<id>; a short ID that several enabled plugins define belongs to none of them.",
          "type": "string",
          "maxLength": 192,
          "pattern": "^([a-z0-9]+([.-][a-z0-9]+)*:)?[a-z][a-z0-9-]{0,63}$"
        },
        "pinAs": { "description": "tool: project saves the selection as the created project's own tool choice.", "enum": ["project"] },
        "minimumVersion": { "type": "string", "description": "tool: one to three dotted numbers." },
        "maximumVersion": { "type": "string", "description": "text and enum: the highest version the value may name, a template over earlier fields such as ${field.jdk.major}." }
      }
    },
    "generatorConditionalValue": {
      "oneOf": [
        { "type": "string" },
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["value", "when"],
          "properties": { "value": { "type": "string" }, "when": { "$ref": "#/$defs/generatorConditions" } }
        }
      ]
    },
    "generatorStep": {
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "source"],
          "properties": {
            "kind": { "const": "files" },
            "source": { "type": "string", "description": "Package-relative template directory." },
            "target": { "type": "string", "description": "Project-relative directory template." },
            "when": { "$ref": "#/$defs/generatorConditions" }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "command", "mayUseNetwork"],
          "properties": {
            "kind": { "const": "command" },
            "command": { "type": "string", "pattern": "^[^/\\\\\\s]+$" },
            "arguments": { "type": "array", "maxItems": 64, "items": { "$ref": "#/$defs/generatorConditionalValue" } },
            "environment": { "type": "object", "maxProperties": 16, "additionalProperties": { "type": "string" } },
            "collect": { "type": "string" },
            "mayUseNetwork": { "type": "boolean" },
            "timeoutSeconds": { "type": "integer", "minimum": 1, "maximum": 1800 },
            "when": { "$ref": "#/$defs/generatorConditions" }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "url"],
          "properties": {
            "kind": { "const": "archive" },
            "url": { "type": "string", "description": "https address without query or fragment; http only for loopback hosts." },
            "query": {
              "type": "array",
              "maxItems": 32,
              "items": {
                "type": "object",
                "additionalProperties": false,
                "required": ["name", "value"],
                "properties": {
                  "name": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,120}$" },
                  "value": { "type": "string" },
                  "when": { "$ref": "#/$defs/generatorConditions" },
                  "omitEmpty": { "type": "boolean" }
                }
              }
            },
            "when": { "$ref": "#/$defs/generatorConditions" }
          }
        }
      ]
    },
    "projectGenerator": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "displayName", "section", "steps"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z][a-z0-9-]{0,63}$" },
        "displayName": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "minLength": 1, "maxLength": 480 },
        "section": { "enum": ["project", "generator"] },
        "icon": { "$ref": "#/$defs/uiIcon" },
        "order": { "type": "integer", "minimum": 0, "maximum": 1000 },
        "fields": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/generatorField" } },
        "requirements": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "languageID": { "type": "string" },
              "buildSystemID": { "type": "string" },
              "when": { "$ref": "#/$defs/generatorConditions" }
            },
            "oneOf": [ { "required": ["languageID"] }, { "required": ["buildSystemID"] } ]
          }
        },
        "steps": { "type": "array", "minItems": 1, "maxItems": 16, "items": { "$ref": "#/$defs/generatorStep" } },
        "openFiles": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "oneOf": [
              { "type": "string" },
              {
                "type": "object",
                "additionalProperties": false,
                "required": ["path", "when"],
                "properties": { "path": { "type": "string" }, "when": { "$ref": "#/$defs/generatorConditions" } }
              }
            ]
          }
        }
      }
    },
    "uiIcon": {
      "type": "object",
      "additionalProperties": false,
      "oneOf": [
        {
          "required": [
            "host"
          ],
          "not": {
            "anyOf": [
              {
                "required": [
                  "path"
                ]
              },
              {
                "required": [
                  "darkPath"
                ]
              },
              {
                "properties": {
                  "mode": {
                    "const": "original"
                  }
                },
                "required": [
                  "mode"
                ]
              }
            ]
          }
        },
        {
          "required": [
            "path"
          ],
          "not": {
            "required": [
              "host"
            ]
          }
        }
      ],
      "properties": {
        "host": {
          "enum": [
            "tool-window",
            "plugin",
            "database",
            "services",
            "terminal",
            "search",
            "refresh",
            "reset",
            "run",
            "debug",
            "settings",
            "add",
            "remove",
            "git",
            "problems"
          ]
        },
        "path": {
          "type": "string",
          "maxLength": 256,
          "pattern": "^(?!/)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))[^:\\\\]+\\.(svg|png)$"
        },
        "darkPath": {
          "type": "string",
          "maxLength": 256,
          "pattern": "^(?!/)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))[^:\\\\]+\\.(svg|png)$"
        },
        "mode": {
          "enum": [
            "template",
            "original"
          ],
          "default": "template"
        }
      }
    },
    "setting": {
      "description": "One user-adjustable option. A type refuses the fields it does not use. Comparisons between values (default within the range, among the options, or matching the pattern; distinct option values) are checked by Core.",
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "type", "title", "default"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z][A-Za-z0-9]*$", "maxLength": 120 },
        "type": { "enum": ["integer", "enum", "boolean", "multiSelect", "text", "file", "directory"] },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 480 },
        "default": { "type": ["integer", "string", "boolean", "array"] },
        "minimum": { "type": "integer" },
        "maximum": { "type": "integer" },
        "unit": { "type": "string", "minLength": 1, "maxLength": 120 },
        "options": {
          "description": "Choices of an enum (at most 16) or multiSelect (at most 32) setting, in display order.",
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["value", "title"],
            "properties": {
              "value": { "$ref": "#/$defs/settingToken" },
              "title": { "type": "string", "minLength": 1, "maxLength": 120 }
            }
          }
        },
        "scope": { "description": "global (default): one value for every project. project: the open project may override it.", "enum": ["global", "project"] },
        "effect": { "description": "When a change takes effect: restart (default), immediate (pushed through workspaceConfiguration, which must use the setting), reload, or nextRun.", "enum": ["restart", "immediate", "reload", "nextRun"] },
        "page": { "$ref": "#/$defs/settingPage" },
        "section": { "description": "Heading the setting is grouped under on its page.", "type": "string", "minLength": 1, "maxLength": 120 },
        "pattern": { "description": "text only: regular expression the whole value must match; at most 256 bytes.", "type": "string", "minLength": 1, "maxLength": 256 },
        "maxLength": { "description": "text only: longest value in Unicode scalars; 256 when absent.", "type": "integer", "minimum": 1, "maximum": 1024 },
        "placeholder": { "description": "text, file, and directory only: hint shown in an empty field.", "type": "string", "minLength": 1, "maxLength": 120 }
      },
      "allOf": [
        {
          "if": { "required": ["type"], "properties": { "type": { "const": "integer" } } },
          "then": {
            "required": ["minimum", "maximum"],
            "properties": { "default": { "type": "integer" }, "options": false, "pattern": false, "maxLength": false, "placeholder": false }
          }
        },
        {
          "if": { "required": ["type"], "properties": { "type": { "const": "enum" } } },
          "then": {
            "required": ["options"],
            "properties": { "default": { "$ref": "#/$defs/settingToken" }, "options": { "maxItems": 16 }, "minimum": false, "maximum": false, "unit": false, "pattern": false, "maxLength": false, "placeholder": false }
          }
        },
        {
          "if": { "required": ["type"], "properties": { "type": { "const": "multiSelect" } } },
          "then": {
            "required": ["options"],
            "properties": {
              "default": { "description": "Distinct option values.", "type": "array", "maxItems": 32, "uniqueItems": true, "items": { "$ref": "#/$defs/settingToken" } },
              "minimum": false, "maximum": false, "unit": false, "pattern": false, "maxLength": false, "placeholder": false
            }
          }
        },
        {
          "if": { "required": ["type"], "properties": { "type": { "const": "boolean" } } },
          "then": {
            "properties": { "default": { "type": "boolean" }, "minimum": false, "maximum": false, "unit": false, "options": false, "pattern": false, "maxLength": false, "placeholder": false }
          }
        },
        {
          "if": { "required": ["type"], "properties": { "type": { "const": "text" } } },
          "then": {
            "required": ["pattern"],
            "properties": {
              "default": { "$comment": "Use an absolute end assertion: Python's $ also matches before a final LF, unlike ECMAScript without multiline mode.", "description": "Never starts with '-' and contains no control characters.", "type": "string", "maxLength": 1024, "pattern": "^(?!-)[^\\u0000-\\u001f\\u007f-\\u009f]*(?![\\s\\S])" },
              "minimum": false, "maximum": false, "unit": false, "options": false
            },
            "if": { "not": { "required": ["maxLength"] } },
            "then": { "properties": { "default": { "maxLength": 256 } } }
          }
        },
        {
          "if": { "required": ["type"], "properties": { "type": { "enum": ["file", "directory"] } } },
          "then": {
            "properties": { "default": { "description": "A path setting starts empty.", "const": "" }, "minimum": false, "maximum": false, "unit": false, "options": false, "pattern": false, "maxLength": false }
          }
        }
      ]
    },
    "settingToken": {
      "description": "Letters, digits, '.', '_', and '-': an option value, or the language or build system ID a settings page names.",
      "type": "string",
      "pattern": "^[A-Za-z0-9._-]+(?![\\s\\S])",
      "maxLength": 120
    },
    "settingPage": {
      "description": "The settings page that shows the entry besides the plugin's own page, named by exactly one language or build system ID. The language or build system may come from another plugin.",
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "maxProperties": 1,
      "properties": {
        "languageID": { "$ref": "#/$defs/settingToken" },
        "buildSystemID": { "$ref": "#/$defs/settingToken" }
      }
    },
    "settingAction": {
      "description": "A button the host draws on the plugin's settings page and on page. It invokes function, one of the plugin's own plugin functions, with empty params.",
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "title", "function"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z][A-Za-z0-9]*(?![\\s\\S])", "maxLength": 120 },
        "title": { "type": "string", "minLength": 1, "maxLength": 120 },
        "description": { "type": "string", "maxLength": 480 },
        "page": { "$ref": "#/$defs/settingPage" },
        "section": { "type": "string", "minLength": 1, "maxLength": 120 },
        "function": { "description": "Plugin function ID: dot-separated lowerCamelCase segments.", "type": "string", "maxLength": 128, "pattern": "^[a-z][A-Za-z0-9]*(\\.[a-z][A-Za-z0-9]*)*(?![\\s\\S])" },
        "confirm": { "description": "Ask before invoking, for actions that discard state.", "type": "boolean" }
      }
    },
    "fileNameList": {
      "type": "array",
      "items": { "type": "string", "minLength": 1 }
    },
    "language": {
      "type": "object",
      "additionalProperties": false,
      "required": ["id", "displayName"],
      "properties": {
        "id": { "type": "string", "pattern": "^[a-z0-9+_-]+$" },
        "displayName": { "type": "string", "minLength": 1 },
        "fileExtensions": { "$ref": "#/$defs/fileNameList" },
        "fileNames": { "$ref": "#/$defs/fileNameList" },
        "projectFileNames": { "$ref": "#/$defs/fileNameList" },
        "dependencies": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "managementFileNames": { "$ref": "#/$defs/fileNameList" },
            "projectDependencyPaths": { "$ref": "#/$defs/fileNameList" },
            "projectBinaryPaths": { "$ref": "#/$defs/fileNameList" }
          }
        },
        "grammar": {
          "description": "Syntax highlighting from a package file, applied by the editor without any process.",
          "type": "object",
          "additionalProperties": false,
          "required": ["kind", "path"],
          "properties": {
            "kind": { "description": "Highlighting engine of the file. Only textmate is defined: a TextMate grammar in the JSON form VS Code reads (.tmLanguage.json).", "enum": ["textmate"] },
            "path": { "description": "Package-relative grammar file inside the package.", "type": "string", "minLength": 1 }
          }
        },
        "configuration": {
          "description": "Comment and bracket behavior of the editor.",
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "lineComment": { "$ref": "#/$defs/editorDelimiter" },
            "blockComment": { "$ref": "#/$defs/editorDelimiterPair" },
            "brackets": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/editorDelimiterPair" } },
            "autoClosingPairs": { "type": "array", "maxItems": 32, "items": { "$ref": "#/$defs/editorDelimiterPair" } }
          }
        }
      }
    },
    "editorDelimiter": { "type": "string", "minLength": 1, "maxLength": 16 },
    "editorDelimiterPair": {
      "type": "array",
      "minItems": 2,
      "maxItems": 2,
      "items": { "$ref": "#/$defs/editorDelimiter" }
    },
    "protocolName": {
      "description": "An LSP method or command name: non-empty text of at most 256 bytes without whitespace or control characters.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^[^\\s\\u0000-\\u001f\\u007f]+$"
    },
    "languageServer": {
      "type": "object",
      "$ref": "#/$defs/processLaunch",
      "unevaluatedProperties": false,
      "required": ["languageID"],
      "allOf": [
        {
          "if": { "required": ["launch"], "properties": { "launch": { "required": ["kind"], "properties": { "kind": { "const": "backend" } } } } },
          "then": { "properties": { "arguments": false, "validationArguments": false, "runtimeDependencies": false, "initializationOptions": false }, "not": { "required": ["hostIntegration"] } }
        }
      ],
      "properties": {
        "languageID": { "type": "string" },
        "languageIdentifier": { "type": "string", "minLength": 1 },
        "workspaceConfiguration": {
          "description": "What the server reads through workspace/configuration and receives again in workspace/didChangeConfiguration. String leaves may be ${setting:<id>} templates, including settings whose effect is immediate, and no other variable.",
          "type": "object"
        },
        "requestMethods": {
          "description": "LSP methods the plugin backend may send with languageServer/request or languageServer/notify. The methods the host sends itself are refused. Requires the languageServer.request permission.",
          "type": "array",
          "maxItems": 64,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/protocolName" }
        },
        "commands": {
          "description": "Workspace/executeCommand commands the backend may run. Declared exactly when requestMethods lists workspace/executeCommand.",
          "type": "array",
          "maxItems": 128,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/protocolName" }
        },
        "serializedCommands": {
          "description": "Commands that run one at a time; a later request for a running command joins it. Each is also listed in commands.",
          "type": "array",
          "maxItems": 128,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/protocolName" }
        },
        "forwardNotifications": {
          "description": "Server notifications the host forwards to the backend. Requires the languageServer.request permission.",
          "type": "array",
          "maxItems": 32,
          "uniqueItems": true,
          "items": { "$ref": "#/$defs/protocolName" }
        },
        "state": {
          "description": "How the host keeps the server's per-workspace state directories.",
          "type": "object",
          "additionalProperties": false,
          "required": ["scope", "retention"],
          "properties": {
            "scope": { "const": "workspace" },
            "retention": {
              "type": "object",
              "additionalProperties": false,
              "required": ["maxEntries", "maxAgeDays"],
              "properties": {
                "maxEntries": { "type": "integer", "minimum": 1, "maximum": 64 },
                "maxAgeDays": { "type": "integer", "minimum": 1, "maximum": 365 }
              }
            }
          }
        },
        "remote": {
          "description": "Whether the server works on a remote workspace. Supported when absent.",
          "enum": ["supported", "unsupported"]
        },
        "hostIntegration": {
          "description": "Reserved. Core implements no host integration, so any ID is refused with plugin.integration.unsupported.",
          "type": "object",
          "additionalProperties": false,
          "required": ["id"],
          "properties": {
            "id": { "type": "string", "minLength": 1 }
          }
        }
      }
    },
    "processLaunch": {
      "description": "The launch fields a language server, a build provider, and a VCS provider share; all are LSP base-protocol processes and pass the same validation.",
      "type": "object",
      "required": ["launch"],
      "properties": {
        "launch": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "required": ["kind", "path"],
              "properties": {
                "kind": { "const": "packaged" },
                "path": { "type": "string", "minLength": 1 }
              }
            },
            {
              "type": "object",
              "additionalProperties": false,
              "required": ["kind", "commands"],
              "properties": {
                "kind": { "const": "systemCommand" },
                "commands": {
                  "type": "array",
                  "minItems": 1,
                  "items": { "type": "string", "pattern": "^[^/\\\\\\s]+$" }
                }
              }
            },
            {
              "description": "A packaged entry file started by a tool, either a runtime the plugin ships or a tool definition the host resolves.",
              "type": "object",
              "additionalProperties": false,
              "required": ["kind", "tool", "entry"],
              "properties": {
                "kind": { "const": "runtime" },
                "tool": { "description": "The ID of a tool definition listed in requiresTools.", "$ref": "#/$defs/toolchainToolID" },
                "minimumVersion": { "$ref": "#/$defs/minimumVersion" },
                "packagedRuntime": { "type": "string", "minLength": 1 },
                "runtimeArguments": { "type": "array", "items": { "type": "string" } },
                "entry": { "type": "string", "minLength": 1 }
              }
            },
            {
              "description": "Language servers only: the plugin backend answers the command line each time the server starts. Core refuses it in any other process.",
              "type": "object",
              "additionalProperties": false,
              "required": ["kind", "function"],
              "properties": {
                "kind": { "const": "backend" },
                "function": { "description": "Plugin function ID: dot-separated lowerCamelCase segments.", "type": "string", "maxLength": 128, "pattern": "^[a-z][A-Za-z0-9]*(\\.[a-z][A-Za-z0-9]*)*(?![\\s\\S])" },
                "timeoutMilliseconds": { "type": "integer", "minimum": 1000, "maximum": 120000 }
              }
            }
          ]
        },
        "arguments": { "description": "Launch templates include ${logDir}, supplied explicitly as absolute logDirectory by the host for the current session plugin files directory; never inferred from installation paths.", "type": "array", "items": { "type": "string" } },
        "validationArguments": { "type": "array", "items": { "type": "string" } },
        "runtimeDependencies": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": ["tool"],
            "properties": { "tool": { "description": "The ID of a tool definition listed in requiresTools.", "$ref": "#/$defs/toolchainToolID" } }
          }
        },
        "initializationOptions": {
          "description": "LSP initializationOptions; string values are launch templates.",
          "type": "object"
        }
      }
    },
    "buildProvider": {
      "description": "The LSP base-protocol process that answers lithe/build/model and lithe/build/dependencies. It either names a language server of the same plugin or declares its own server process.",
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["languageServer", "executesProjectCode", "mayUseNetwork"],
          "properties": {
            "languageServer": {
              "description": "The languageID of a language server the same plugin declares; the host reuses that session.",
              "type": "string",
              "minLength": 1
            },
            "executesProjectCode": { "type": "boolean" },
            "mayUseNetwork": { "type": "boolean" }
          }
        },
        {
          "type": "object",
          "$ref": "#/$defs/processLaunch",
          "unevaluatedProperties": false,
          "required": ["executesProjectCode", "mayUseNetwork"],
          "properties": {
            "executesProjectCode": { "type": "boolean" },
            "mayUseNetwork": { "type": "boolean" }
          }
        }
      ]
    },
    "backend": {
      "description": "Launch fields of the plugin backend. ${workspaceStateDir} is refused because one backend process serves every workspace; each workspace's state directory arrives in its context instead.",
      "type": "object",
      "$ref": "#/$defs/processLaunch",
      "unevaluatedProperties": false
    },
    "vcsProvider": {
      "description": "A VCS provider process (https://github.com/Lithe-IDEA/Lithe-core-rust/blob/main/rust/contracts/vcs-provider-v1.md). Detection uses the markers only and never starts the process; capabilities are negotiated, not declared.",
      "type": "object",
      "$ref": "#/$defs/processLaunch",
      "unevaluatedProperties": false,
      "required": ["id", "displayName", "detection", "mayUseNetwork"],
      "properties": {
        "id": {
          "description": "Stable VCS ID; git is reserved for the built-in support.",
          "type": "string",
          "pattern": "^[a-z][a-z0-9-]{0,31}$",
          "not": { "const": "git" }
        },
        "displayName": { "type": "string", "minLength": 1, "maxLength": 64 },
        "detection": {
          "type": "object",
          "additionalProperties": false,
          "required": ["markers"],
          "properties": {
            "markers": {
              "description": "Entries directly inside a root that mark it.",
              "type": "array",
              "minItems": 1,
              "maxItems": 8,
              "items": {
                "type": "object",
                "additionalProperties": false,
                "required": ["name", "type"],
                "properties": {
                  "name": { "type": "string", "minLength": 1, "maxLength": 255, "pattern": "^[^/\\\\]+$", "not": { "enum": [".", ".."] } },
                  "type": { "enum": ["directory", "file"] }
                }
              }
            }
          }
        },
        "metadataPaths": {
          "description": "Root-relative paths the host watches; a change means the status may be stale.",
          "type": "array",
          "maxItems": 16,
          "items": { "type": "string", "minLength": 1 }
        },
        "tool": {
          "description": "The VCS client the provider drives. The host resolves it like a systemCommand launch and passes its absolute path with every request.",
          "type": "object",
          "additionalProperties": false,
          "required": ["commands"],
          "properties": {
            "commands": {
              "type": "array",
              "minItems": 1,
              "maxItems": 8,
              "items": { "type": "string", "pattern": "^[^/\\\\\\s]+$" }
            },
            "validationArguments": { "type": "array", "items": { "type": "string" } }
          }
        },
        "mayUseNetwork": { "type": "boolean" }
      }
    },
    "minimumVersion": {
      "description": "One to three dot-separated numbers, for example 21 or 18.17.",
      "type": "string",
      "pattern": "^[0-9]{1,9}(\\.[0-9]{1,9}){0,2}$"
    },
    "executable": {
      "type": "object",
      "additionalProperties": false,
      "oneOf": [
        { "required": ["command"], "not": { "required": ["toolchain"] } },
        { "required": ["toolchain"], "not": { "required": ["command"] } }
      ],
      "properties": {
        "command": { "type": "string", "pattern": "^[^/\\\\\\s]+$" },
        "toolchain": { "type": "string", "pattern": "^[a-z0-9-]+$" }
      }
    },
    "argument": {
      "oneOf": [
        { "type": "string" },
        {
          "type": "object",
          "additionalProperties": false,
          "required": ["value", "when"],
          "properties": {
            "value": { "type": "string" },
            "when": { "enum": ["fileSelected", "noFileSelected"] }
          }
        }
      ]
    },
    "argumentList": {
      "type": "array",
      "items": { "$ref": "#/$defs/argument" }
    },
    "executionProvider": {
      "type": "object",
      "additionalProperties": false,
      "required": ["languageID"],
      "properties": {
        "languageID": { "type": "string" },
        "run": {
          "type": "object",
          "additionalProperties": false,
          "required": ["executable", "arguments"],
          "properties": {
            "executable": { "$ref": "#/$defs/executable" },
            "arguments": { "$ref": "#/$defs/argumentList" }
          }
        },
        "test": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "frameworkID",
            "workspaceLabel",
            "projectMarkers",
            "testFilePatterns",
            "executable",
            "workspaceArguments",
            "fileArguments",
            "testCaseArguments"
          ],
          "properties": {
            "frameworkID": { "type": "string", "pattern": "^[a-z0-9-]+$" },
            "workspaceLabel": { "type": "string", "minLength": 1 },
            "projectMarkers": { "$ref": "#/$defs/fileNameList" },
            "testFilePatterns": { "$ref": "#/$defs/fileNameList" },
            "executable": { "$ref": "#/$defs/executable" },
            "workspaceArguments": { "$ref": "#/$defs/argumentList" },
            "fileArguments": { "$ref": "#/$defs/argumentList" },
            "testCaseArguments": { "$ref": "#/$defs/argumentList" }
          }
        }
      }
    },
    "buildArgument": {
      "description": "A template string, or one emitted only when every condition holds. See README.md for variables and guards.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "value",
            "when"
          ],
          "properties": {
            "value": {
              "type": "string"
            },
            "when": {
              "oneOf": [
                {
                  "$ref": "#/$defs/buildCondition"
                },
                {
                  "type": "array",
                  "items": {
                    "$ref": "#/$defs/buildCondition"
                  },
                  "minItems": 1
                }
              ]
            }
          }
        }
      ]
    },
    "buildCondition": {
      "enum": [
        "projectSelected",
        "noProjectSelected",
        "nestedProjectSelected",
        "noNestedProjectSelected",
        "targetSelected",
        "noTargetSelected",
        "suiteSelected",
        "noSuiteSelected",
        "caseSelected",
        "noCaseSelected"
      ]
    },
    "buildArgumentList": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/buildArgument"
      },
      "maxItems": 64
    },
    "executableCandidate": {
      "oneOf": [
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "path"
          ],
          "properties": {
            "kind": {
              "const": "projectFile"
            },
            "path": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[^/\\\\]"
            },
            "requires": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "pattern": "^[^/\\\\]"
              }
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "variable",
            "path"
          ],
          "properties": {
            "kind": {
              "const": "environment"
            },
            "variable": {
              "type": "string",
              "pattern": "^[A-Z_][A-Z0-9_]*$",
              "maxLength": 64
            },
            "path": {
              "type": "string",
              "minLength": 1,
              "pattern": "^[^/\\\\]"
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "command"
          ],
          "properties": {
            "kind": {
              "const": "command"
            },
            "command": {
              "type": "string",
              "pattern": "^[^/\\\\\\s]+$"
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "runtime"
          ],
          "properties": {
            "kind": {
              "const": "runtime"
            },
            "runtime": {
              "type": "string",
              "pattern": "^[a-z][a-z0-9-]*$",
              "maxLength": 64
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "settingID"
          ],
          "properties": {
            "kind": {
              "const": "setting"
            },
            "settingID": {
              "type": "string",
              "minLength": 1
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "kind",
            "toolchainID"
          ],
          "properties": {
            "kind": {
              "const": "toolchain"
            },
            "toolchainID": {
              "type": "string",
              "maxLength": 192,
              "pattern": "^(?:[a-z0-9]+(?:[.-][a-z0-9]+)*:)?[a-z][a-z0-9-]{0,63}$"
            },
            "id": {
              "type": "string",
              "minLength": 1,
              "maxLength": 64
            },
            "priority": {
              "type": "integer",
              "minimum": -2147483648,
              "maximum": 2147483647
            },
            "insertBefore": {
              "type": "string",
              "minLength": 1
            },
            "insertAfter": {
              "type": "string",
              "minLength": 1
            },
            "platforms": {
              "type": "array",
              "items": {
                "enum": [
                  "macos",
                  "linux",
                  "windows"
                ]
              }
            }
          },
          "allOf": [
            {
              "not": {
                "required": [
                  "priority",
                  "insertBefore"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "priority",
                  "insertAfter"
                ]
              }
            },
            {
              "not": {
                "required": [
                  "insertBefore",
                  "insertAfter"
                ]
              }
            }
          ]
        }
      ]
    },
    "buildExecutable": {"$ref": "#/$defs/executableCandidate"},
    "buildVersionProbe": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "arguments",
        "pattern"
      ],
      "properties": {
        "arguments": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "pattern": {
          "type": "string",
          "minLength": 1,
          "maxLength": 512
        }
      }
    },
    "buildFieldSpec": {
      "description": "A selector (\"\", @key, /a/b, or $/a/b), a selector with a transform, or a literal value.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "from",
            "transform"
          ],
          "properties": {
            "from": {
              "type": "string"
            },
            "transform": {
              "enum": [
                "lastSegment"
              ]
            }
          }
        },
        {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "value"
          ],
          "properties": {
            "value": {
              "type": "string",
              "minLength": 1,
              "maxLength": 512
            }
          }
        }
      ]
    },
    "buildPredicate": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "pointer"
      ],
      "properties": {
        "pointer": {
          "type": "string"
        },
        "equals": {},
        "exists": {
          "type": "boolean"
        }
      },
      "oneOf": [
        {
          "required": [
            "equals"
          ],
          "not": {
            "required": [
              "exists"
            ]
          }
        },
        {
          "required": [
            "exists"
          ],
          "not": {
            "required": [
              "equals"
            ]
          }
        }
      ]
    },
    "buildFieldMap": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/$defs/buildFieldSpec"
      }
    },
    "buildExecution": {
      "enum": [
        "application",
        "service",
        "task"
      ]
    },
    "buildScopes": {
      "type": "array",
      "items": {
        "enum": [
          "workspace",
          "project",
          "target"
        ]
      },
      "minItems": 1
    },
    "buildTargetRule": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "name",
        "tags"
      ],
      "properties": {
        "each": {
          "type": "string"
        },
        "where": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/buildPredicate"
          }
        },
        "fallback": {
          "type": "boolean"
        },
        "whenFile": {
          "type": "string",
          "minLength": 1,
          "pattern": "^[^/\\\\]"
        },
        "name": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "path": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "tags": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[a-z0-9-]+$",
            "maxLength": 64
          }
        },
        "properties": {
          "$ref": "#/$defs/buildFieldMap"
        }
      }
    },
    "buildModelMap": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "projects": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name"
            ],
            "properties": {
              "each": {
                "type": "string"
              },
              "where": {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/buildPredicate"
                }
              },
              "fallback": {
                "type": "boolean"
              },
              "whenFile": {
                "type": "string",
                "minLength": 1,
                "pattern": "^[^/\\\\]"
              },
              "name": {
                "$ref": "#/$defs/buildFieldSpec"
              },
              "displayName": {
                "$ref": "#/$defs/buildFieldSpec"
              },
              "path": {
                "$ref": "#/$defs/buildFieldSpec"
              },
              "properties": {
                "$ref": "#/$defs/buildFieldMap"
              },
              "targets": {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/buildTargetRule"
                }
              },
              "contentRoots": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "path",
                    "kind"
                  ],
                  "properties": {
                    "each": {
                      "type": "string"
                    },
                    "where": {
                      "type": "array",
                      "items": {
                        "$ref": "#/$defs/buildPredicate"
                      }
                    },
                    "fallback": {
                      "type": "boolean"
                    },
                    "whenFile": {
                      "type": "string",
                      "minLength": 1,
                      "pattern": "^[^/\\\\]"
                    },
                    "path": {
                      "$ref": "#/$defs/buildFieldSpec"
                    },
                    "kind": {
                      "enum": [
                        "source",
                        "resource",
                        "testSource",
                        "testResource",
                        "generatedSource",
                        "generatedTestSource",
                        "excluded"
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "optionValues": {
          "type": "object",
          "additionalProperties": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "each",
              "value"
            ],
            "properties": {
              "each": {
                "type": "string"
              },
              "where": {
                "type": "array",
                "items": {
                  "$ref": "#/$defs/buildPredicate"
                }
              },
              "value": {
                "$ref": "#/$defs/buildFieldSpec"
              }
            }
          }
        }
      }
    },
    "buildDependencyRule": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "each",
        "name"
      ],
      "properties": {
        "each": {
          "type": "string"
        },
        "where": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/buildPredicate"
          }
        },
        "name": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "group": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "version": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "scope": {
          "$ref": "#/$defs/buildFieldSpec"
        },
        "properties": {
          "$ref": "#/$defs/buildFieldMap"
        }
      }
    },
    "buildSystem": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "displayName",
        "detection",
        "invocation"
      ],
      "properties": {
        "configuration": {"type": "object", "additionalProperties": false, "required": ["source"], "properties": {"source": {"const": "provider"}}, "description": "Format-independent native configuration facts and provider-owned staged editing; requires buildProviders and an owned provider."},
        "modelSharing": {"type": "object", "additionalProperties": false, "properties": {"options": {"type": "array", "maxItems": 32, "uniqueItems": true, "items": {"type": "string"}}}, "description": "Opt into publishing normalized projects, targets and content roots, plus only these explicitly shared ordinary build option values. Never tasks, run plans, settings or optionValues."},
        "modelInputs": {"type": "array", "minItems": 1, "maxItems": 8, "uniqueItems": true, "items": {"type": "object", "additionalProperties": false, "required": ["pluginID", "buildSystemID"], "properties": {"pluginID": {"type": "string"}, "buildSystemID": {"type": "string"}}}, "description": "Exact optional producer slots, sorted by Core. Missing or disabled producers are unavailable and never installed or activated automatically."},
        "id": {
          "type": "string",
          "pattern": "^[a-z][a-z0-9-]*$",
          "maxLength": 64
        },
        "displayName": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "icon": {
          "description": "Icon of the build system's tool window and activity bar entry; display only.",
          "$ref": "#/$defs/uiIcon"
        },
        "detection": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "markers"
          ],
          "properties": {
            "markers": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[^/\\\\]+$"
              },
              "minItems": 1,
              "maxItems": 32
            },
            "nesting": {
              "enum": [
                "separate",
                "outermost"
              ]
            },
            "priority": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            }
          }
        },
        "invocation": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "executables"
          ],
          "properties": {
            "executableSetting": {
              "deprecated": true,
              "type": "string",
              "description": "Global file setting with effect reload or nextRun; empty uses discovery, nonempty must be used without fallback.",
              "pattern": "^[a-z][a-zA-Z0-9]*$",
              "maxLength": 120
            },
            "executables": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/buildExecutable"
              },
              "minItems": 1,
              "maxItems": 32
            },
            "globalArguments": {
              "$ref": "#/$defs/buildArgumentList"
            },
            "environmentInputs": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[A-Z_][A-Z0-9_]*$",
                "maxLength": 64
              }
            },
            "runtimeDependencies": {
              "type": "array",
              "items": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "id"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^[a-z][a-z0-9-]*$",
                    "maxLength": 64
                  },
                  "displayName": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  },
                  "minimumVersion": {
                    "$ref": "#/$defs/minimumVersion"
                  },
                  "executables": {
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/buildExecutable"
                    },
                    "maxItems": 32
                  },
                  "version": {
                    "$ref": "#/$defs/buildVersionProbe"
                  }
                },
                "description": "node and go use host version probes. They may select one toolchain candidate with executables, or take only id and minimumVersion. Other runtimes declare their executables and version probe."
              }
            },
            "version": {
              "$ref": "#/$defs/buildVersionProbe"
            },
            "minimumVersion": {
              "$ref": "#/$defs/minimumVersion"
            }
          }
        },
        "hostIntegration": {
          "description": "Reserved. Core implements no build-system host integration, so any name is refused with plugin.integration.unsupported.",
          "type": "string",
          "minLength": 1
        },
        "provider": {
          "$ref": "#/$defs/buildProvider"
        },
        "options": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "displayName",
              "kind"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z][A-Za-z0-9]*$"
              },
              "displayName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 120
              },
              "kind": {
                "enum": [
                  "boolean",
                  "singleSelect",
                  "multiSelect",
                  "text",
                  "file",
                  "directory"
                ]
              },
              "default": {},
              "scope": {
                "description": "Instance scope; omitted means workspace. Hosts persist each detected root independently.",
                "enum": ["workspace", "instance"]
              },
              "choices": {
                "type": "array",
                "items": {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "value"
                  ],
                  "properties": {
                    "value": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 256
                    },
                    "title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 120
                    }
                  }
                },
                "maxItems": 64
              },
              "choicesFromModel": {
                "type": "boolean"
              },
              "allowCustom": {
                "type": "boolean"
              },
              "separator": {
                "type": "string",
                "minLength": 1
              },
              "arguments": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "environment": {
                "type": "object",
                "propertyNames": {
                  "type": "string",
                  "pattern": "^[A-Z_][A-Z0-9_]*$",
                  "maxLength": 64
                },
                "additionalProperties": {
                  "type": "string"
                }
              },
              "presentation": {
                "description": "Display only. toolbar: a toggle button in the tool window toolbar (boolean options with an icon). tree: a checklist node at the top of the tool window tree (multiSelect options).",
                "enum": ["toolbar", "tree"]
              },
              "icon": {
                "description": "Icon of a toolbar option; only toolbar options have one.",
                "$ref": "#/$defs/uiIcon"
              }
            }
          },
          "maxItems": 32
        },
        "model": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "file",
                "decoder",
                "map"
              ],
              "properties": {
                "source": {
                  "const": "static"
                },
                "file": {
                  "type": "string",
                  "minLength": 1,
                  "pattern": "^[^/\\\\]"
                },
                "decoder": {
                  "enum": [
                    "toml"
                  ]
                },
                "map": {
                  "$ref": "#/$defs/buildModelMap"
                }
              }
            },
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "arguments",
                "decoder",
                "executesProjectCode",
                "mayUseNetwork"
              ],
              "properties": {
                "source": {
                  "const": "command"
                },
                "arguments": {
                  "$ref": "#/$defs/buildArgumentList"
                },
                "output": {
                  "enum": [
                    "stdout",
                    "outputFile"
                  ]
                },
                "decoder": {
                  "enum": [
                    "jsonStream",
                    "litheBuildModel"
                  ]
                },
                "map": {
                  "$ref": "#/$defs/buildModelMap"
                },
                "executesProjectCode": {
                  "type": "boolean"
                },
                "mayUseNetwork": {
                  "type": "boolean"
                }
              }
            },
            {
              "description": "The build provider answers lithe/build/model with a litheBuildModel document.",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source"
              ],
              "properties": {
                "source": {
                  "const": "provider"
                }
              }
            }
          ]
        },
        "tasks": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id",
              "displayName",
              "group",
              "arguments"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]*$",
                "maxLength": 64
              },
              "displayName": {
                "type": "string",
                "minLength": 1,
                "maxLength": 120
              },
              "group": {
                "enum": [
                  "lifecycle",
                  "build",
                  "test",
                  "run",
                  "verification",
                  "documentation",
                  "other"
                ]
              },
              "execution": {
                "$ref": "#/$defs/buildExecution"
              },
              "scopes": {
                "$ref": "#/$defs/buildScopes"
              },
              "fromModel": {
                "type": "boolean"
              },
              "targetTags": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^[a-z0-9-]+$",
                  "maxLength": 64
                }
              },
              "source": {
                "description": "Omitted expands argv in Core; provider sends lithe/build/execute. Provider tasks require empty arguments, and task execution.",
                "enum": ["provider"]
              },
              "preparation": {
                "description": "Automatic project preparation selected by workflow purpose and canonical model source role. Bindings must be unique within one build system; no prompted or fromModel tasks.",
                "type": "object",
                "additionalProperties": false,
                "required": ["purpose", "sourceRoles"],
                "properties": {
                  "purpose": { "type": "string", "pattern": "^[a-zA-Z][a-zA-Z0-9._-]*$", "maxLength": 120 },
                  "sourceRoles": {
                    "type": "array", "minItems": 1, "maxItems": 6, "uniqueItems": true,
                    "items": { "enum": ["source", "generatedSource", "resource", "testSource", "generatedTestSource", "testResource"] }
                  }
                }
              },
              "requiresUserArguments": {
                "type": "boolean"
              },
              "description": {
                "type": "string",
                "maxLength": 1024
              },
              "category": {
                "description": "Headings the host files the task under, outermost first; the default for model tasks of a fromModel template. Display only.",
                "type": "array",
                "minItems": 1,
                "maxItems": 4,
                "items": { "type": "string", "minLength": 1, "maxLength": 120 }
              },
              "arguments": {
                "$ref": "#/$defs/buildArgumentList"
              }
            }
          },
          "maxItems": 128
        },
        "run": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "id"
            ],
            "properties": {
              "debug": {
                "description": "Same-package native launch adapter, or a public registry configurationType for connection attach (service runs).",
                "type": "object", "additionalProperties": false,
                "oneOf": [{"required": ["adapter"]}, {"required": ["configurationType"]}],
                "properties": {
                  "adapter": { "type": "string", "pattern": "^[a-z][a-z0-9-]*$", "maxLength": 64 },
                  "configurationType": { "type": "string", "minLength": 1, "maxLength": 256 }
                }
              },
              "source": {
                "description": "Provider-owned application or service/task preparation, fromTargets only, without host command templates.",
                "enum": ["provider"]
              },
              "id": {
                "type": "string",
                "pattern": "^[a-z][a-z0-9-]*$",
                "maxLength": 64
              },
              "fromTargets": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "tags"
                ],
                "properties": {
                  "tags": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z0-9-]+$",
                      "maxLength": 64
                    },
                    "minItems": 1
                  }
                }
              },
              "fromTasks": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "templates": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[a-z][a-z0-9-]*$",
                      "maxLength": 64
                    }
                  },
                  "executions": {
                    "type": "array",
                    "items": {
                      "$ref": "#/$defs/buildExecution"
                    }
                  }
                }
              },
              "execution": {
                "$ref": "#/$defs/buildExecution"
              },
              "name": {
                "type": "string",
                "minLength": 1
              },
              "arguments": {
                "$ref": "#/$defs/buildArgumentList"
              },
              "workingDirectory": {
                "enum": [
                  "project",
                  "root"
                ]
              },
              "extension": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              }
            },
            "oneOf": [
              {
                "required": [
                  "fromTargets"
                ],
                "not": {
                  "required": [
                    "fromTasks"
                  ]
                }
              },
              {
                "required": [
                  "fromTasks"
                ],
                "not": {
                  "required": [
                    "fromTargets"
                  ]
                }
              }
            ]
          }
        },
        "test": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "scopes",
            "arguments"
          ],
          "properties": {
            "selectorKinds": {
              "type": "array", "maxItems": 16, "uniqueItems": true,
              "description": "Public opaque semantic selector namespaces; provider tests required.",
              "items": {"type": "string", "maxLength": 120, "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$"}
            },
            "discovery": {
              "type": "boolean",
              "description": "Opt in to lithe/build/discoverTests; requires provider test source and suite/case filters."
            },
            "source": {
              "description": "Omitted expands argv; provider sends lithe/build/test, requires empty arguments, and plugin-owned report decoding.",
              "enum": ["provider"]
            },
            "scopes": {
              "$ref": "#/$defs/buildScopes"
            },
            "targetTags": {
              "type": "array",
              "items": {
                "type": "string",
                "pattern": "^[a-z0-9-]+$",
                "maxLength": 64
              }
            },
            "filters": {
              "type": "array",
              "items": {
                "enum": [
                  "suite",
                  "case"
                ]
              }
            },
            "arguments": {
              "$ref": "#/$defs/buildArgumentList"
            },
            "results": {
              "oneOf": [
                {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "decoder",
                    "reports"
                  ],
                  "properties": {
                    "decoder": {
                      "enum": [
                        "junitXml",
                        "litheTestResults"
                      ]
                    },
                    "reports": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "pattern": "^[^/\\\\]"
                      },
                      "minItems": 1
                    }
                  }
                },
                {
                  "type": "object",
                  "additionalProperties": false,
                  "required": [
                    "decoder"
                  ],
                  "properties": {
                    "decoder": {
                      "const": "provider"
                    }
                  }
                }
              ]
            }
          }
        },
        "diagnostics": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "decoder",
                "patterns"
              ],
              "properties": {
                "decoder": {
                  "const": "lineMatcher"
                },
                "patterns": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "regex",
                      "file",
                      "line",
                      "message"
                    ],
                    "properties": {
                      "regex": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 512
                      },
                      "file": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "line": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "column": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "message": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "severity": {
                        "type": "integer",
                        "minimum": 1
                      },
                      "severities": {
                        "type": "object",
                        "additionalProperties": {
                          "enum": [
                            "error",
                            "warning",
                            "information",
                            "hint"
                          ]
                        }
                      },
                      "defaultSeverity": {
                        "enum": [
                          "error",
                          "warning",
                          "information",
                          "hint"
                        ]
                      }
                    }
                  },
                  "minItems": 1,
                  "maxItems": 32
                }
              }
            },
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "decoder"
              ],
              "properties": {
                "decoder": {
                  "const": "litheDiagnostics"
                }
              }
            }
          ]
        },
        "dependencies": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "scopes",
                "arguments",
                "decoder",
                "executesProjectCode",
                "mayUseNetwork"
              ],
              "properties": {
                "source": {
                  "const": "command"
                },
                "scopes": {
                  "$ref": "#/$defs/buildScopes"
                },
                "arguments": {
                  "$ref": "#/$defs/buildArgumentList"
                },
                "output": {
                  "enum": [
                    "stdout",
                    "outputFile"
                  ]
                },
                "decoder": {
                  "enum": [
                    "jsonStream",
                    "litheDependencies"
                  ]
                },
                "map": {
                  "$ref": "#/$defs/buildDependencyRule"
                },
                "executesProjectCode": {
                  "type": "boolean"
                },
                "mayUseNetwork": {
                  "type": "boolean"
                }
              }
            },
            {
              "description": "The build provider answers lithe/build/dependencies with a litheDependencies document.",
              "type": "object",
              "additionalProperties": false,
              "required": [
                "source",
                "scopes"
              ],
              "properties": {
                "source": {
                  "const": "provider"
                },
                "scopes": {
                  "$ref": "#/$defs/buildScopes"
                }
              }
            }
          ]
        },
        "sync": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "watch"
          ],
          "properties": {
            "watch": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "pattern": "^[^/\\\\]"
              },
              "minItems": 1,
              "maxItems": 32
            }
          }
        },
        "layout": {
          "type": "object",
          "additionalProperties": false,
          "properties": {
            "excluded": {
              "type": "array",
              "items": {
                "type": "string",
                "minLength": 1,
                "pattern": "^[^/\\\\]"
              },
              "maxItems": 32
            }
          }
        }
      }
    },
    "toolchainIdentifier": {
      "type": "string",
      "pattern": "^[a-z][a-z0-9-]{0,63}$"
    },
    "toolchainToolID": {
      "type": "string",
      "pattern": "^(?:[a-z0-9]+(?:[.-][a-z0-9]+)*:)?[a-z][a-z0-9-]{0,63}$",
      "maxLength": 192
    },
    "toolchainLabel": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[^\\u0000-\\u001f\\u007f]+$"
    },
    "toolchainRelativePath": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^(?!/)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))[^/\\\\:*?\\u0000-\\u001f\\u007f]+(?:/[^/\\\\:*?\\u0000-\\u001f\\u007f]+)*$"
    },
    "toolchainBoundedGlob": {
      "description": "At most eight segments; only single-segment * is supported, never **, ?, character classes, or traversal. Semantic validation also bounds expansion.",
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "pattern": "^(?!/)(?!.*\\*\\*)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))[^/\\\\:?\\[\\]{}\\u0000-\\u001f\\u007f]+(?:/[^/\\\\:?\\[\\]{}\\u0000-\\u001f\\u007f]+){0,7}$"
    },
    "toolchainCommand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$"
    },
    "toolchainSafeEnvironmentName": {
      "type": "string",
      "maxLength": 64,
      "pattern": "^(?!PATH$)(?!DYLD_)(?!LD_)[A-Z_][A-Z0-9_]*$"
    },
    "toolchainPlatforms": {
      "type": "array",
      "minItems": 1,
      "maxItems": 3,
      "uniqueItems": true,
      "items": {
        "enum": [
          "macos",
          "windows",
          "linux"
        ]
      }
    },
    "toolchainVersion": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "arguments",
        "pattern"
      ],
      "properties": {
        "arguments": {
          "type": "array",
          "minItems": 1,
          "maxItems": 8,
          "items": {
            "type": "string",
            "pattern": "^--?[A-Za-z][A-Za-z0-9-]*$",
            "maxLength": 64
          }
        },
        "pattern": {
          "description": "Rust-regex-compatible, first capture is a dotted numeric version. Validity, capture count and runtime bounds require semantic checks.",
          "type": "string",
          "minLength": 1,
          "maxLength": 512
        }
      }
    },
    "toolchainExecutableLayout": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "path"
      ],
      "properties": {
        "path": {
          "$ref": "#/$defs/toolchainRelativePath"
        },
        "platforms": {
          "$ref": "#/$defs/toolchainPlatforms"
        }
      }
    },
    "toolchainHomeLayout": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "match",
        "home"
      ],
      "properties": {
        "match": {
          "allOf": [
            {
              "$ref": "#/$defs/toolchainBoundedGlob"
            },
            {
              "pattern": "^[^/]+$"
            }
          ]
        },
        "home": {
          "oneOf": [
            {
              "const": "."
            },
            {
              "$ref": "#/$defs/toolchainRelativePath"
            }
          ]
        },
        "platforms": {
          "$ref": "#/$defs/toolchainPlatforms"
        }
      }
    },
    "toolchainDiscovery": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "root",
        "pattern"
      ],
      "properties": {
        "root": {
          "oneOf": [
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "kind"
              ],
              "properties": {
                "kind": {
                  "const": "home"
                }
              }
            },
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "kind",
                "variable"
              ],
              "properties": {
                "kind": {
                  "const": "environment"
                },
                "variable": {
                  "$ref": "#/$defs/toolchainSafeEnvironmentName"
                }
              }
            },
            {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "kind",
                "path"
              ],
              "properties": {
                "kind": {
                  "const": "absolute"
                },
                "path": {
                  "type": "string",
                  "minLength": 2,
                  "maxLength": 256,
                  "pattern": "^(?:/|[A-Za-z]:[\\\\/])[^\\u0000-\\u001f\\u007f]*$"
                }
              }
            }
          ]
        },
        "pattern": {
          "$ref": "#/$defs/toolchainBoundedGlob"
        },
        "platforms": {
          "$ref": "#/$defs/toolchainPlatforms"
        }
      }
    },
    "toolchainWrapper": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "path"
      ],
      "properties": {
        "path": {
          "$ref": "#/$defs/toolchainRelativePath"
        },
        "requires": {
          "type": "array",
          "maxItems": 8,
          "uniqueItems": true,
          "items": {
            "$ref": "#/$defs/toolchainRelativePath"
          }
        },
        "platforms": {
          "$ref": "#/$defs/toolchainPlatforms"
        }
      }
    },
    "toolchainCandidateMetadata": {
      "type": "object",
      "properties": {
        "id": {
          "$ref": "#/$defs/toolchainIdentifier"
        },
        "priority": {
          "type": "integer",
          "minimum": -2147483648,
          "maximum": 2147483647
        },
        "insertBefore": {
          "$ref": "#/$defs/toolchainIdentifier"
        },
        "insertAfter": {
          "$ref": "#/$defs/toolchainIdentifier"
        },
        "platforms": {
          "$ref": "#/$defs/toolchainPlatforms"
        }
      },
      "not": {
        "anyOf": [
          {
            "required": [
              "priority",
              "insertBefore"
            ]
          },
          {
            "required": [
              "priority",
              "insertAfter"
            ]
          },
          {
            "required": [
              "insertBefore",
              "insertAfter"
            ]
          }
        ]
      }
    },
    "toolchainCandidate": {
      "$ref": "#/$defs/toolchainCandidateMetadata",
      "unevaluatedProperties": false,
      "oneOf": [
        {
          "required": [
            "kind",
            "settingID",
            "layer"
          ],
          "properties": {
            "kind": {
              "const": "setting"
            },
            "settingID": {
              "const": "executable"
            },
            "layer": {
              "enum": [
                "project",
                "global"
              ]
            }
          }
        },
        {
          "required": [
            "kind",
            "scope"
          ],
          "properties": {
            "kind": {
              "const": "toolchain"
            },
            "scope": {
              "enum": [
                "project",
                "global",
                "installed"
              ]
            }
          }
        },
        {
          "required": [
            "kind",
            "path"
          ],
          "properties": {
            "kind": {
              "const": "projectFile"
            },
            "path": {
              "$ref": "#/$defs/toolchainRelativePath"
            },
            "requires": {
              "type": "array",
              "maxItems": 8,
              "items": {
                "$ref": "#/$defs/toolchainRelativePath"
              }
            },
            "projectKind": {
              "enum": [
                "wrapper",
                "environment"
              ],
              "default": "wrapper"
            },
            "home": {
              "oneOf": [
                {
                  "const": "."
                },
                {
                  "$ref": "#/$defs/toolchainRelativePath"
                }
              ]
            }
          },
          "allOf": [
            {
              "if": {
                "required": [
                  "projectKind"
                ],
                "properties": {
                  "projectKind": {
                    "const": "environment"
                  }
                }
              },
              "then": {
                "required": [
                  "home"
                ]
              },
              "else": {
                "not": {
                  "required": [
                    "home"
                  ]
                }
              }
            }
          ]
        },
        {
          "required": [
            "kind",
            "variable",
            "path"
          ],
          "properties": {
            "kind": {
              "const": "environment"
            },
            "variable": {
              "$ref": "#/$defs/toolchainSafeEnvironmentName"
            },
            "path": {
              "$ref": "#/$defs/toolchainRelativePath"
            }
          }
        },
        {
          "required": [
            "kind",
            "command"
          ],
          "properties": {
            "kind": {
              "const": "command"
            },
            "command": {
              "$ref": "#/$defs/toolchainCommand"
            }
          }
        }
      ]
    },
    "toolchainLaunchTokens": {
      "type": "array",
      "minItems": 1,
      "maxItems": 32,
      "prefixItems": [
        {
          "const": "${executable}"
        }
      ],
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256,
        "pattern": "^(?:\\$\\{(?:home|executable|entry|runtimeArguments|arguments)\\}|[^$\\u0000-\\u001f\\u007f]+)$"
      }
    },
    "toolchainToolDefinition": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "displayName",
        "executableLayouts",
        "executables",
        "version",
        "commands",
        "launch"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/toolchainToolID"
        },
        "displayName": {
          "$ref": "#/$defs/toolchainLabel"
        },
        "icon": {
          "$ref": "#/$defs/uiIcon"
        },
        "executableLayouts": {
          "type": "array",
          "minItems": 1,
          "maxItems": 8,
          "items": {
            "$ref": "#/$defs/toolchainExecutableLayout"
          }
        },
        "executables": {
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "items": {
            "$ref": "#/$defs/toolchainCandidate"
          }
        },
        "version": {
          "$ref": "#/$defs/toolchainVersion"
        },
        "homeLayouts": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "$ref": "#/$defs/toolchainHomeLayout"
          }
        },
        "discovery": {
          "type": "array",
          "maxItems": 16,
          "items": {
            "$ref": "#/$defs/toolchainDiscovery"
          }
        },
        "homeVariable": {
          "$ref": "#/$defs/toolchainSafeEnvironmentName"
        },
        "commands": {
          "type": "array",
          "minItems": 1,
          "maxItems": 8,
          "uniqueItems": true,
          "items": {
            "$ref": "#/$defs/toolchainCommand"
          }
        },
        "wrappers": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "$ref": "#/$defs/toolchainWrapper"
          }
        },
        "exports": {
          "type": "array",
          "maxItems": 16,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "name",
              "value"
            ],
            "properties": {
              "name": {
                "$ref": "#/$defs/toolchainSafeEnvironmentName"
              },
              "value": {
                "enum": [
                  "${home}",
                  "${executable}"
                ]
              }
            }
          }
        },
        "pathPrepend": {
          "type": "array",
          "maxItems": 8,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "maxLength": 256,
            "pattern": "^\\$\\{home\\}(?:/(?!\\.{1,2}(?:/|$))[^/\\\\:$*?\\u0000-\\u001f\\u007f]+)*$"
          }
        },
        "launch": {
          "$ref": "#/$defs/toolchainLaunchTokens"
        }
      }
    },
    "toolchainProvider": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "id",
        "displayName",
        "tools"
      ],
      "properties": {
        "id": {
          "$ref": "#/$defs/toolchainIdentifier"
        },
        "displayName": {
          "$ref": "#/$defs/toolchainLabel"
        },
        "tools": {
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "uniqueItems": true,
          "items": {
            "$ref": "#/$defs/toolchainToolID"
          }
        },
        "watchFiles": {
          "type": "array",
          "minItems": 1,
          "maxItems": 32,
          "uniqueItems": true,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "pattern",
              "reader"
            ],
            "properties": {
              "pattern": {
                "$ref": "#/$defs/toolchainBoundedGlob"
              },
              "reader": {
                "enum": [
                  "native",
                  "compatible"
                ]
              }
            }
          }
        }
      }
    }
  }
}