opencode-toolbox/toolbox.schema.json at main · assagman/opencode-toolbox · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://unpkg.com/opencode-toolbox@latest/toolbox.schema.json",
  "allowTrailingCommas": true,
  "allowComments": true,
  "title": "OpenCode Toolbox Configuration",
  "description": "Configuration schema for opencode-toolbox plugin",
  "type": "object",
  "properties": {
    "$schema": {
      "type": "string",
      "description": "JSON Schema reference for editor support"
    },
    "mcp": {
      "type": "object",
      "description": "MCP servers to connect to",
      "additionalProperties": {
        "oneOf": [
          {
            "type": "object",
            "description": "Local MCP server (stdio)",
            "properties": {
              "type": {
                "type": "string",
                "const": "local",
                "description": "Server type: local process via stdio"
              },
              "command": {
                "type": "array",
                "items": { "type": "string" },
                "minItems": 1,
                "description": "Command and arguments to spawn the MCP server"
              },
              "environment": {
                "type": "object",
                "additionalProperties": { "type": "string" },
                "description": "Environment variables for the process. Use {env:VAR_NAME} for interpolation."
              }
            },
            "required": ["type", "command"],
            "additionalProperties": false
          },
          {
            "type": "object",
            "description": "Remote MCP server (HTTP/SSE)",
            "properties": {
              "type": {
                "type": "string",
                "const": "remote",
                "description": "Server type: remote HTTP/SSE endpoint"
              },
              "url": {
                "type": "string",
                "format": "uri",
                "description": "Remote MCP endpoint URL"
              },
              "headers": {
                "type": "object",
                "additionalProperties": { "type": "string" },
                "description": "HTTP headers for authentication. Use {env:VAR_NAME} for interpolation."
              }
            },
            "required": ["type", "url"],
            "additionalProperties": false
          }
        ]
      }
    },
    "settings": {
      "type": "object",
      "description": "Plugin settings",
      "properties": {
        "defaultLimit": {
          "type": "integer",
          "minimum": 1,
          "maximum": 20,
          "default": 5,
          "description": "Default number of search results to return"
        },
        "initMode": {
          "type": "string",
          "enum": ["eager", "lazy"],
          "default": "eager",
          "description": "Initialization mode: 'eager' connects on plugin load, 'lazy' connects on first use"
        },
        "connection": {
          "type": "object",
          "description": "Connection settings for MCP servers",
          "properties": {
            "connectTimeout": {
              "type": "integer",
              "minimum": 100,
              "maximum": 60000,
              "default": 5000,
              "description": "Connection timeout in milliseconds"
            },
            "requestTimeout": {
              "type": "integer",
              "minimum": 100,
              "maximum": 300000,
              "default": 30000,
              "description": "Request timeout in milliseconds"
            },
            "retryAttempts": {
              "type": "integer",
              "minimum": 0,
              "maximum": 10,
              "default": 2,
              "description": "Number of retry attempts on connection failure"
            },
            "retryDelay": {
              "type": "integer",
              "minimum": 0,
              "maximum": 30000,
              "default": 1000,
              "description": "Delay between retries in milliseconds"
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  },
  "required": ["mcp"],
  "additionalProperties": false
}