Shell-B-Agents/agent.schema.json at main · ShellB-App/Shell-B-Agents · 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
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "$id": "https://github.com/ShellB-App/Shell-B-Agents/agent.schema.json",
 "title": "Shell:B agent",
 "description": "One agent persona for the Shell:B Agent Lab: the fields the Lab saves, plus author, license, version and tags. scripts/validate.py applies the same rules plus the tool catalogue in scripts/tools.json.",
 "type": "object",
 "required": ["name", "title", "avatar", "color", "description", "systemPrompt", "tools", "author", "license"],
 "additionalProperties": false,
 "properties": {
  "id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]{1,39}$", "description": "Optional; must equal the folder name."},
  "name": {"type": "string", "minLength": 1, "maxLength": 32},
  "title": {"type": "string", "minLength": 1, "maxLength": 40, "description": "The role shown under the name, e.g. \"Travel planner\"."},
  "avatar": {"type": "string", "minLength": 1, "maxLength": 8, "description": "One symbol or emoji."},
  "color": {
   "type": "array", "minItems": 2, "maxItems": 2,
   "items": {"type": "string", "pattern": "^#[0-9a-fA-F]{6}$"},
   "description": "Two hex colours for the avatar gradient."
  },
  "description": {"type": "string", "minLength": 1, "maxLength": 200, "description": "One sentence for the agent menu."},
  "systemPrompt": {"type": "string", "minLength": 80, "maxLength": 12000},
  "model": {
   "type": "string", "default": "default",
   "pattern": "^(default|[A-Za-z0-9][\\w.\\-/:]{0,99})$",
   "description": "\"default\" means the installing Shell:B's default chat model; otherwise an Ollama tag such as qwen3:30b."
  },
  "needs": {
   "type": "array", "uniqueItems": true,
   "items": {"enum": ["tools", "vision", "thinking"]},
   "description": "Model capabilities the persona relies on."
  },
  "temperature": {"type": "number", "minimum": 0, "maximum": 2, "default": 0.6},
  "effort": {"enum": ["off", "low", "medium", "high"], "default": "medium", "description": "Reasoning effort for thinking models."},
  "tools": {
   "type": "array", "uniqueItems": true,
   "items": {"type": "string"},
   "description": "Tool ids from scripts/tools.json. Tools Shell:B adds by rule (weather, wiki, codex…) need not be listed."
  },
  "author": {"type": "string", "minLength": 1},
  "license": {"type": "string", "minLength": 1, "description": "An SPDX id: MIT, CC0-1.0, CC-BY-4.0 …"},
  "version": {"type": "string", "default": "1.0"},
  "tags": {"type": "array", "items": {"type": "string", "minLength": 1}},
  "homepage": {"type": "string", "format": "uri"}
 }
}