@sortedyuan/maybecode 0.3.2 → 0.5.0

package/dist/maybecode-config.schema.json

@@ -0,0 +1,1765 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MaybeCode configuration",
+  "description": "Configuration for May model profiles and provider adapters. Each application describes its own entry under apps.",
+  "type": "object",
+  "required": [
+    "providers"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Optional editor hint pointing to this schema."
+    },
+    "defaultModel": {
+      "$ref": "#/$defs/nonEmptyString",
+      "description": "Default model profile name."
+    },
+    "providers": {
+      "type": "object",
+      "description": "Named provider connections.",
+      "propertyNames": {
+        "$ref": "#/$defs/nonEmptyString"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/provider"
+      }
+    },
+    "models": {
+      "type": "object",
+      "description": "Named, user-selectable model profiles.",
+      "default": {},
+      "propertyNames": {
+        "$ref": "#/$defs/nonEmptyString"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/model"
+      }
+    },
+    "apps": {
+      "type": "object",
+      "description": "Application-owned settings. Each application validates its own entry.",
+      "default": {},
+      "propertyNames": {
+        "$ref": "#/$defs/nonEmptyString"
+      },
+      "additionalProperties": {
+        "type": "object"
+      },
+      "properties": {
+        "maybecode": {
+          "$ref": "#/$defs/maybecode"
+        }
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "pluginSelections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "module"
+        ],
+        "properties": {
+          "module": {
+            "type": "string",
+            "minLength": 1
+          },
+          "export": {
+            "type": "string",
+            "minLength": 1,
+            "default": "default"
+          },
+          "config": {},
+          "enabled": {
+            "type": "boolean",
+            "default": true
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "nonEmptyString": {
+      "type": "string",
+      "pattern": "\\S"
+    },
+    "positiveInteger": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "reasoningEffort": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Model-specific value. Use model capabilities or MaybeCode /effort to discover supported levels."
+    },
+    "provider": {
+      "type": "object",
+      "required": [
+        "adapter"
+      ],
+      "properties": {
+        "adapter": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "apiKey": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "apiKeyEnv": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "baseURL": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "capabilities": {
+          "$ref": "#/$defs/modelCapabilities"
+        },
+        "options": {
+          "type": "object",
+          "description": "Adapter-specific shared options. A model profile may override them."
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "openai-responses"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/openaiResponsesOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "openai-chat-completions"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/openaiChatOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "deepseek-chat"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/deepseekOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "zhipu-chat"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/zhipuOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "kimi-chat"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/kimiOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "anthropic-messages"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/anthropicOptions"
+              }
+            }
+          }
+        }
+      ],
+      "not": {
+        "required": [
+          "apiKey",
+          "apiKeyEnv"
+        ]
+      },
+      "additionalProperties": false
+    },
+    "model": {
+      "type": "object",
+      "required": [
+        "provider",
+        "model"
+      ],
+      "properties": {
+        "provider": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "adapter": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "model": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "contextWindowTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxOutputTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "options": {
+          "$ref": "#/$defs/knownModelOptions"
+        },
+        "capabilities": {
+          "$ref": "#/$defs/modelCapabilities"
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "openai-responses"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/openaiResponsesOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "openai-chat-completions"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/openaiChatOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "deepseek-chat"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/deepseekOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "zhipu-chat"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/zhipuOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "kimi-chat"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/kimiOptions"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "adapter": {
+                "const": "anthropic-messages"
+              }
+            },
+            "required": [
+              "adapter"
+            ]
+          },
+          "then": {
+            "properties": {
+              "options": {
+                "$ref": "#/$defs/anthropicOptions"
+              }
+            }
+          }
+        }
+      ],
+      "additionalProperties": false
+    },
+    "modelCapabilities": {
+      "type": "object",
+      "description": "Explicit model capability overrides. These take precedence over provider discovery and May's built-in catalog.",
+      "properties": {
+        "fields": {
+          "$ref": "#/$defs/capabilityFields"
+        },
+        "reasoning": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "$ref": "#/$defs/reasoningCapabilities"
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "capabilityFields": {
+      "type": "object",
+      "propertyNames": {
+        "enum": [
+          "input.text",
+          "input.image",
+          "input.audio",
+          "input.file",
+          "input.resource",
+          "input.image.sources",
+          "input.audio.sources",
+          "input.file.sources",
+          "output.text",
+          "output.image",
+          "output.audio",
+          "tools",
+          "tools.maxCalls",
+          "structuredOutput.json",
+          "structuredOutput.jsonSchema",
+          "structuredOutput.schemaDialects",
+          "structuredOutput.schemaConstraint",
+          "contextWindowTokens",
+          "maxOutputTokens",
+          "maxImages",
+          "maxAttachments",
+          "maxAttachmentBytes",
+          "fileTypes",
+          "parameters",
+          "contextCompaction",
+          "reasoning.modes"
+        ]
+      },
+      "additionalProperties": {
+        "type": "boolean"
+      },
+      "properties": {
+        "contextWindowTokens": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "maxOutputTokens": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "maxImages": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "maxAttachments": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "maxAttachmentBytes": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "tools.maxCalls": {
+          "$ref": "#/$defs/capabilityLimit"
+        },
+        "input.image.sources": {
+          "$ref": "#/$defs/capabilitySources"
+        },
+        "input.audio.sources": {
+          "$ref": "#/$defs/capabilitySources"
+        },
+        "input.file.sources": {
+          "$ref": "#/$defs/capabilitySources"
+        },
+        "fileTypes": {
+          "$ref": "#/$defs/capabilityStrings"
+        },
+        "reasoning.modes": {
+          "$ref": "#/$defs/capabilityStrings"
+        },
+        "structuredOutput.schemaDialects": {
+          "$ref": "#/$defs/capabilityStrings"
+        },
+        "structuredOutput.schemaConstraint": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object"
+            }
+          ]
+        },
+        "parameters": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object"
+            }
+          ]
+        }
+      }
+    },
+    "capabilityLimit": {
+      "oneOf": [
+        {
+          "const": false
+        },
+        {
+          "$ref": "#/$defs/positiveInteger"
+        }
+      ]
+    },
+    "capabilityStrings": {
+      "oneOf": [
+        {
+          "const": false
+        },
+        {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        }
+      ]
+    },
+    "capabilitySources": {
+      "oneOf": [
+        {
+          "const": false
+        },
+        {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "url",
+              "base64",
+              "file"
+            ]
+          }
+        }
+      ]
+    },
+    "reasoningCapabilities": {
+      "type": "object",
+      "required": [
+        "efforts"
+      ],
+      "properties": {
+        "efforts": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "defaultEffort": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "knownModelOptions": {
+      "type": "object",
+      "description": "Options are interpreted by the effective adapter. Unknown keys remain allowed for custom adapters.",
+      "properties": {
+        "responseFormat": {
+          "$ref": "#/$defs/modelResponseFormat"
+        },
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "thinking": {
+          "oneOf": [
+            {
+              "type": "string",
+              "enum": [
+                "enabled",
+                "disabled"
+              ]
+            },
+            {
+              "$ref": "#/$defs/kimiThinking"
+            },
+            {
+              "$ref": "#/$defs/anthropicThinking"
+            }
+          ]
+        },
+        "clearThinking": {
+          "type": "boolean"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "reasoningSummary": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "concise",
+            "detailed"
+          ]
+        },
+        "maxTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxOutputTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "serverCompactThreshold": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "store": {
+          "type": "boolean"
+        },
+        "apiVersion": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "additionalProperties": true
+    },
+    "openaiResponsesOptions": {
+      "type": "object",
+      "properties": {
+        "responseFormat": {
+          "$ref": "#/$defs/modelResponseFormat"
+        },
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "maxOutputTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "reasoningSummary": {
+          "type": "string",
+          "enum": [
+            "auto",
+            "concise",
+            "detailed"
+          ]
+        },
+        "serverCompactThreshold": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "store": {
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "openaiChatOptions": {
+      "type": "object",
+      "properties": {
+        "responseFormat": {
+          "$ref": "#/$defs/modelResponseFormat"
+        },
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "maxOutputTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "store": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false
+    },
+    "deepseekOptions": {
+      "type": "object",
+      "properties": {
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "thinking": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ]
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "maxTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        }
+      },
+      "additionalProperties": false
+    },
+    "zhipuOptions": {
+      "type": "object",
+      "properties": {
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "thinking": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ]
+        },
+        "clearThinking": {
+          "type": "boolean"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "maxTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        }
+      },
+      "additionalProperties": false
+    },
+    "kimiThinking": {
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "enabled",
+            "disabled"
+          ]
+        },
+        "keep": {
+          "enum": [
+            "all",
+            null
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "kimiOptions": {
+      "type": "object",
+      "properties": {
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "thinking": {
+          "$ref": "#/$defs/kimiThinking"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "maxTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        }
+      },
+      "additionalProperties": false
+    },
+    "anthropicThinking": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": [
+            "type",
+            "budgetTokens"
+          ],
+          "properties": {
+            "type": {
+              "const": "enabled"
+            },
+            "budgetTokens": {
+              "$ref": "#/$defs/positiveInteger"
+            },
+            "display": {
+              "type": "string",
+              "enum": [
+                "summarized",
+                "omitted"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "const": "adaptive"
+            },
+            "display": {
+              "type": "string",
+              "enum": [
+                "summarized",
+                "omitted"
+              ]
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": [
+            "type"
+          ],
+          "properties": {
+            "type": {
+              "const": "disabled"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "anthropicOptions": {
+      "type": "object",
+      "properties": {
+        "promptCaching": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "ttl": {
+                  "enum": [
+                    "5m",
+                    "1h"
+                  ]
+                },
+                "cacheInstructions": {
+                  "type": "boolean"
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "unknownCapabilityPolicy": {
+          "enum": [
+            "allow",
+            "require-known"
+          ]
+        },
+        "thinking": {
+          "$ref": "#/$defs/anthropicThinking"
+        },
+        "reasoningEffort": {
+          "$ref": "#/$defs/reasoningEffort"
+        },
+        "maxTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "apiVersion": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "modelResponseFormat": {
+      "oneOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "json"
+            }
+          },
+          "required": [
+            "type"
+          ],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "jsonSchema"
+            },
+            "name": {
+              "type": "string",
+              "pattern": "^[A-Za-z0-9_-]{1,64}$"
+            },
+            "schema": {
+              "type": "object"
+            },
+            "strict": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "type",
+            "name",
+            "schema"
+          ],
+          "additionalProperties": false
+        }
+      ]
+    },
+    "runBudget": {
+      "type": "object",
+      "properties": {
+        "maxDurationMs": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 2147483647
+        },
+        "maxSteps": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxModelCalls": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxToolCalls": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxTotalTokens": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxCostUsd": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "tokenPrices": {
+          "type": "object",
+          "required": [
+            "inputUsdPerMillion",
+            "outputUsdPerMillion"
+          ],
+          "properties": {
+            "inputUsdPerMillion": {
+              "type": "number",
+              "minimum": 0
+            },
+            "outputUsdPerMillion": {
+              "type": "number",
+              "minimum": 0
+            },
+            "cachedReadUsdPerMillion": {
+              "type": "number",
+              "minimum": 0
+            },
+            "cachedWriteUsdPerMillion": {
+              "type": "number",
+              "minimum": 0
+            },
+            "reasoningUsdPerMillion": {
+              "type": "number",
+              "minimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "pricing": {
+          "$ref": "#/$defs/tokenPriceSchedule"
+        }
+      },
+      "not": {
+        "required": [
+          "tokenPrices",
+          "pricing"
+        ]
+      },
+      "if": {
+        "required": [
+          "maxCostUsd"
+        ]
+      },
+      "then": {
+        "anyOf": [
+          {
+            "required": [
+              "tokenPrices"
+            ]
+          },
+          {
+            "required": [
+              "pricing"
+            ]
+          }
+        ],
+        "properties": {
+          "pricing": {
+            "properties": {
+              "currency": {
+                "const": "USD"
+              }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "tokenPriceSchedule": {
+      "type": "object",
+      "required": [
+        "id",
+        "version",
+        "currency",
+        "source",
+        "effectiveAt",
+        "inputPerMillion",
+        "outputPerMillion"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "version": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "currency": {
+          "type": "string",
+          "pattern": "^[A-Z]{3}$"
+        },
+        "source": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "effectiveAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "inputPerMillion": {
+          "type": "number",
+          "minimum": 0
+        },
+        "outputPerMillion": {
+          "type": "number",
+          "minimum": 0
+        },
+        "cachedReadPerMillion": {
+          "type": "number",
+          "minimum": 0
+        },
+        "cachedWritePerMillion": {
+          "type": "number",
+          "minimum": 0
+        },
+        "reasoningPerMillion": {
+          "type": "number",
+          "minimum": 0
+        },
+        "items": {
+          "type": "object",
+          "maxProperties": 64,
+          "additionalProperties": {
+            "type": "object",
+            "required": [
+              "unit",
+              "perUnit"
+            ],
+            "properties": {
+              "unit": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256
+              },
+              "perUnit": {
+                "type": "number",
+                "minimum": 0
+              }
+            },
+            "additionalProperties": false
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "subagentIdentifier": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,63}$",
+      "not": {
+        "enum": [
+          "constructor",
+          "prototype"
+        ]
+      }
+    },
+    "subagentRole": {
+      "type": "object",
+      "properties": {
+        "model": {
+          "$ref": "#/$defs/subagentIdentifier",
+          "description": "Model profile name. Without it the role inherits the main Session model and reasoning effort."
+        },
+        "reasoningEffort": {
+          "type": "string",
+          "pattern": "\\S",
+          "maxLength": 64
+        },
+        "instructions": {
+          "type": "string",
+          "pattern": "^[^\\u0000]*\\S[^\\u0000]*$",
+          "maxLength": 16384
+        },
+        "tools": {
+          "type": "array",
+          "maxItems": 7,
+          "uniqueItems": true,
+          "items": {
+            "enum": [
+              "read",
+              "shell",
+              "edit",
+              "write",
+              "glob",
+              "grep",
+              "fetch"
+            ]
+          }
+        },
+        "delegateTo": {
+          "type": "array",
+          "maxItems": 8,
+          "uniqueItems": true,
+          "items": {
+            "$ref": "#/$defs/subagentIdentifier"
+          }
+        },
+        "runBudget": {
+          "$ref": "#/$defs/runBudget"
+        }
+      },
+      "additionalProperties": false
+    },
+    "mcpStdioServer": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "required": {
+          "type": "boolean",
+          "default": true
+        },
+        "transport": {
+          "const": "stdio",
+          "default": "stdio"
+        },
+        "protocolMode": {
+          "enum": [
+            "legacy",
+            "auto"
+          ],
+          "default": "legacy"
+        },
+        "host": {
+          "$ref": "#/$defs/mcpHostOptions"
+        },
+        "tasks": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable the modern Tasks extension with durable encrypted handles."
+        },
+        "command": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "cwd": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "env": {
+          "type": "object",
+          "propertyNames": {
+            "minLength": 1
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "requestTimeoutMs": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxTotalTimeoutMs": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxBufferSize": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "stderrMaxBytes": {
+          "$ref": "#/$defs/positiveInteger",
+          "default": 16384
+        }
+      },
+      "anyOf": [
+        {
+          "required": [
+            "enabled"
+          ],
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          }
+        },
+        {
+          "required": [
+            "command"
+          ]
+        }
+      ],
+      "additionalProperties": false
+    },
+    "mcpHttpServer": {
+      "type": "object",
+      "required": [
+        "transport"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true
+        },
+        "required": {
+          "type": "boolean",
+          "default": true
+        },
+        "transport": {
+          "const": "streamable-http"
+        },
+        "url": {
+          "$ref": "#/$defs/nonEmptyString",
+          "description": "HTTPS endpoint (HTTP only on loopback); redirects and URL credentials are refused at runtime."
+        },
+        "headers": {
+          "type": "object",
+          "propertyNames": {
+            "minLength": 1
+          },
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "auth": {
+          "$ref": "#/$defs/mcpOAuthOptions"
+        },
+        "protocolMode": {
+          "enum": [
+            "legacy",
+            "auto"
+          ],
+          "default": "auto"
+        },
+        "host": {
+          "$ref": "#/$defs/mcpHostOptions"
+        },
+        "tasks": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable the modern Tasks extension with durable encrypted handles."
+        },
+        "requestTimeoutMs": {
+          "$ref": "#/$defs/positiveInteger"
+        },
+        "maxTotalTimeoutMs": {
+          "$ref": "#/$defs/positiveInteger"
+        }
+      },
+      "anyOf": [
+        {
+          "required": [
+            "enabled"
+          ],
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          }
+        },
+        {
+          "required": [
+            "url"
+          ]
+        }
+      ],
+      "additionalProperties": false
+    },
+    "mcpHostOptions": {
+      "type": "object",
+      "description": "Explicit compatibility options; an active interaction UI and host services are also required.",
+      "properties": {
+        "roots": {
+          "type": "boolean",
+          "default": false
+        },
+        "sampling": {
+          "type": "boolean",
+          "default": false
+        },
+        "legacyRequests": {
+          "const": "isolated",
+          "description": "Use a fresh process/session for each legacy interactive operation, never shared or reused."
+        }
+      },
+      "additionalProperties": false
+    },
+    "mcpOAuthOptions": {
+      "type": "object",
+      "required": [
+        "type"
+      ],
+      "properties": {
+        "type": {
+          "const": "oauth"
+        },
+        "account": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "clientId": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "expectedIssuer": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "clientMetadataUrl": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "scopes": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "authorizationOrigins": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/nonEmptyString"
+          }
+        },
+        "callbackPort": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 65535
+        }
+      },
+      "dependentRequired": {
+        "clientId": [
+          "expectedIssuer"
+        ]
+      },
+      "not": {
+        "required": [
+          "clientId",
+          "clientMetadataUrl"
+        ]
+      },
+      "additionalProperties": false
+    },
+    "maybecode": {
+      "type": "object",
+      "description": "MaybeCode settings.",
+      "properties": {
+        "execution": {
+          "default": {
+            "mode": "host"
+          },
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "const": "host"
+                }
+              },
+              "required": [
+                "mode"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "mode": {
+                  "const": "container"
+                },
+                "image": {
+                  "$ref": "#/$defs/nonEmptyString"
+                },
+                "network": {
+                  "const": "none"
+                },
+                "memoryBytes": {
+                  "$ref": "#/$defs/positiveInteger"
+                },
+                "cpuCount": {
+                  "type": "number",
+                  "exclusiveMinimum": 0
+                }
+              },
+              "required": [
+                "mode",
+                "image",
+                "network",
+                "memoryBytes",
+                "cpuCount"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        },
+        "fetch": {
+          "type": "object",
+          "properties": {
+            "allowedOrigins": {
+              "type": "array",
+              "uniqueItems": true,
+              "items": {
+                "type": "string",
+                "pattern": "^https?://(?:[A-Za-z0-9.-]+|\\[[A-Fa-f0-9:]+\\])(?::[0-9]{1,5})?$"
+              }
+            },
+            "maxBytes": {
+              "$ref": "#/$defs/positiveInteger"
+            },
+            "timeoutMs": {
+              "$ref": "#/$defs/positiveInteger"
+            },
+            "maxRedirects": {
+              "type": "integer",
+              "minimum": 0
+            }
+          },
+          "additionalProperties": false
+        },
+        "requestRecording": {
+          "enum": [
+            "off",
+            "required"
+          ],
+          "default": "required"
+        },
+        "providerBodyRecording": {
+          "type": "boolean",
+          "default": false
+        },
+        "git": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "autoCommit": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "readOnly": {
+                  "type": "boolean",
+                  "default": false
+                },
+                "dataRoot": {
+                  "$ref": "#/$defs/nonEmptyString"
+                },
+                "worktreesRoot": {
+                  "$ref": "#/$defs/nonEmptyString"
+                },
+                "excludedPaths": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/$defs/nonEmptyString"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "plugins": {
+          "$ref": "#/$defs/pluginSelections"
+        },
+        "permissionMode": {
+          "enum": [
+            "default",
+            "yolo"
+          ],
+          "default": "default",
+          "description": "Tool approval mode. yolo auto-approves requests while preserving explicit policy denials."
+        },
+        "persistentRules": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable project-scoped persistent file permissions in .may/permission-rules.json."
+        },
+        "delegationNotifications": {
+          "type": "boolean",
+          "default": false,
+          "description": "Show a notice when a sub-agent task finishes."
+        },
+        "instructionsDirectory": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "skills": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "directories": {
+                  "type": "array",
+                  "maxItems": 32,
+                  "items": {
+                    "$ref": "#/$defs/nonEmptyString"
+                  }
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "runBudget": {
+          "$ref": "#/$defs/runBudget"
+        },
+        "subagents": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true,
+                  "description": "Sub-agent delegation for ordinary requests. Enabled by default."
+                },
+                "roles": {
+                  "type": "object",
+                  "minProperties": 1,
+                  "maxProperties": 8,
+                  "propertyNames": {
+                    "$ref": "#/$defs/subagentIdentifier"
+                  },
+                  "additionalProperties": {
+                    "$ref": "#/$defs/subagentRole"
+                  }
+                },
+                "defaultRole": {
+                  "$ref": "#/$defs/subagentIdentifier"
+                },
+                "limits": {
+                  "type": "object",
+                  "properties": {
+                    "maxConcurrent": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 8,
+                      "default": 2
+                    },
+                    "maxTasks": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 128,
+                      "default": 24
+                    },
+                    "maxDepth": {
+                      "type": "integer",
+                      "minimum": 2,
+                      "maximum": 4,
+                      "default": 3
+                    },
+                    "maxTaskTurns": {
+                      "type": "integer",
+                      "minimum": 2,
+                      "maximum": 16,
+                      "default": 6
+                    },
+                    "maxDurationMs": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 3600000,
+                      "default": 900000
+                    },
+                    "maxInputBytes": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 65536,
+                      "default": 32768
+                    },
+                    "maxOutputBytes": {
+                      "type": "integer",
+                      "minimum": 1,
+                      "maximum": 262144,
+                      "default": 65536
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "runBudget": {
+                  "$ref": "#/$defs/runBudget",
+                  "description": "Per child Run budget."
+                },
+                "maxModelCalls": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 10000,
+                  "default": 128,
+                  "description": "Model calls reserved across the main Run, child Runs and compaction of one request."
+                },
+                "maxTotalTokens": {
+                  "$ref": "#/$defs/positiveInteger",
+                  "description": "Optional token ceiling checked against per-call reservations."
+                },
+                "reservationTokens": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 10000000,
+                  "default": 32768
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "autoCompaction": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "enum": [
+                "prune-summary",
+                "history-reference",
+                "provider-native"
+              ],
+              "default": "prune-summary"
+            }
+          },
+          "additionalProperties": false
+        },
+        "retry": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "maxAttempts": {
+                  "$ref": "#/$defs/positiveInteger"
+                },
+                "baseDelayMs": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "maxDelayMs": {
+                  "type": "number",
+                  "minimum": 0
+                },
+                "jitterRatio": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "observability": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean",
+                  "default": true
+                },
+                "exporter": {
+                  "const": "file",
+                  "default": "file"
+                },
+                "file": {
+                  "$ref": "#/$defs/nonEmptyString"
+                },
+                "samplingRatio": {
+                  "type": "number",
+                  "minimum": 0,
+                  "maximum": 1
+                },
+                "retentionDays": {
+                  "$ref": "#/$defs/positiveInteger",
+                  "default": 60
+                },
+                "batch": {
+                  "type": "object",
+                  "properties": {
+                    "maxQueueSize": {
+                      "$ref": "#/$defs/positiveInteger"
+                    },
+                    "maxExportBatchSize": {
+                      "$ref": "#/$defs/positiveInteger"
+                    },
+                    "scheduledDelayMs": {
+                      "type": "number",
+                      "minimum": 0
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
+            }
+          ]
+        },
+        "mcpServers": {
+          "oneOf": [
+            {
+              "const": false
+            },
+            {
+              "type": "object",
+              "propertyNames": {
+                "pattern": "^[A-Za-z0-9_-]+$"
+              },
+              "additionalProperties": {
+                "oneOf": [
+                  {
+                    "$ref": "#/$defs/mcpStdioServer"
+                  },
+                  {
+                    "$ref": "#/$defs/mcpHttpServer"
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}