vod-devkit 0.4.4 → 0.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +42 -0
- package/QUICKSTART.md +1 -1
- package/README.en.md +190 -56
- package/README.md +210 -56
- package/bin/vod-devkit +502 -460
- package/contract/tools.schema.json +114 -7
- package/integrations/codeartsdoer/host.json +11 -0
- package/integrations/codex/host.json +20 -0
- package/integrations/dsh/host.json +15 -0
- package/integrations/hermes/host.json +20 -0
- package/integrations/opencode/command/vod-doctor.md +10 -0
- package/integrations/opencode/host.json +28 -0
- package/package.json +13 -10
- package/plugins/vod-devkit/.codex-plugin/plugin.json +1 -1
- package/plugins/vod-devkit/build-info.json +3 -3
- package/plugins/vod-devkit/skills/vod-core/SKILL.md +43 -15
- package/plugins/vod-devkit/skills/vod-core/references/acceptance-criteria.md +9 -0
- package/plugins/vod-devkit/skills/vod-core/references/verification-method.md +29 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/SKILL.md +57 -11
- package/plugins/vod-devkit/skills/vod-feedback-collect/references/acceptance-criteria.md +28 -0
- package/plugins/vod-devkit/skills/vod-feedback-collect/references/verification-method.md +31 -0
- package/plugins/vod-devkit/skills/vod-problem-classification-rules/SKILL.md +3 -1
- package/plugins/vod-devkit/skills/vod-scoring-rules/SKILL.md +22 -1
- package/plugins/vod-devkit/vod_mcp/__init__.py +1 -1
- package/plugins/vod-devkit/vod_mcp/attribution.py +378 -0
- package/plugins/vod-devkit/vod_mcp/config_forms.py +154 -0
- package/plugins/vod-devkit/vod_mcp/guardrails.py +25 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/__init__.py +26 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/base.py +73 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/codearts.py +57 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/codex.py +209 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/dsh.py +176 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/generic.py +132 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/hermes.py +76 -0
- package/plugins/vod-devkit/vod_mcp/host_adapters/opencode.py +52 -0
- package/plugins/vod-devkit/vod_mcp/hosts.py +100 -0
- package/plugins/vod-devkit/vod_mcp/packs.py +19 -3
- package/plugins/vod-devkit/vod_mcp/payload.py +174 -0
- package/plugins/vod-devkit/vod_mcp/remote_app.py +100 -0
- package/plugins/vod-devkit/vod_mcp/server.py +43 -16
- package/plugins/vod-devkit/vod_mcp/skills_registry.py +124 -0
- package/plugins/vod-devkit/vod_mcp/tools.py +455 -55
- package/plugins/vod-devkit/vod_mcp/transport_remote.py +289 -0
- package/plugins/vod-devkit/vod_mcp/update_check.py +133 -0
- package/skills/vod-core/SKILL.md +43 -15
- package/skills/vod-core/references/acceptance-criteria.md +9 -0
- package/skills/vod-core/references/verification-method.md +29 -0
- package/skills/vod-feedback-collect/SKILL.md +57 -11
- package/skills/vod-feedback-collect/references/acceptance-criteria.md +28 -0
- package/skills/vod-feedback-collect/references/verification-method.md +31 -0
- package/skills/vod-problem-classification-rules/SKILL.md +3 -1
- package/skills/vod-scoring-rules/SKILL.md +22 -1
- package/vod_mcp/__init__.py +1 -1
- package/vod_mcp/attribution.py +378 -0
- package/vod_mcp/config_forms.py +154 -0
- package/vod_mcp/guardrails.py +25 -0
- package/vod_mcp/host_adapters/__init__.py +26 -0
- package/vod_mcp/host_adapters/__pycache__/__init__.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/base.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codearts.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/codex.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/dsh.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/generic.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/hermes.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/__pycache__/opencode.cpython-314.pyc +0 -0
- package/vod_mcp/host_adapters/base.py +73 -0
- package/vod_mcp/host_adapters/codearts.py +57 -0
- package/vod_mcp/host_adapters/codex.py +209 -0
- package/vod_mcp/host_adapters/dsh.py +176 -0
- package/vod_mcp/host_adapters/generic.py +132 -0
- package/vod_mcp/host_adapters/hermes.py +76 -0
- package/vod_mcp/host_adapters/opencode.py +52 -0
- package/vod_mcp/hosts.py +100 -0
- package/vod_mcp/packs.py +19 -3
- package/vod_mcp/payload.py +174 -0
- package/vod_mcp/remote_app.py +100 -0
- package/vod_mcp/server.py +43 -16
- package/vod_mcp/skills_registry.py +124 -0
- package/vod_mcp/tools.py +455 -55
- package/vod_mcp/transport_remote.py +289 -0
- package/vod_mcp/update_check.py +133 -0
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
"""通用 MCP 宿主适配(A 层兜底)。
|
|
2
|
+
|
|
3
|
+
对标 huaweicloud-devkit 的 `configureGenericMCP()`:不认识/没有专属模块的宿主
|
|
4
|
+
不该"不支持",而应"能装 + 给片段"。
|
|
5
|
+
|
|
6
|
+
两条纪律:
|
|
7
|
+
- **外科式合并**:只写 `mcpServers["vod-devkit"]` 一个键,其它 server 与用户
|
|
8
|
+
自有键原样保留;首次改动前落 `.bak`。共享配置文件永不整文件重写语义删除。
|
|
9
|
+
- **宁可不装不可装错**:现有文件不是合法 JSON / 不是对象 → 报错退出、字节不动。
|
|
10
|
+
|
|
11
|
+
探测表只收录「已知 config 形态」的宿主(JSON + mcpServers)。不在表里也能装:
|
|
12
|
+
`--mcp-config <path>` 显式给出路径即可。
|
|
13
|
+
"""
|
|
14
|
+
import json
|
|
15
|
+
import shutil
|
|
16
|
+
import sys
|
|
17
|
+
from pathlib import Path
|
|
18
|
+
|
|
19
|
+
from vod_mcp.host_adapters.base import server_env, server_entry
|
|
20
|
+
|
|
21
|
+
HOST = "generic"
|
|
22
|
+
SUPPORTS_REMOTE = True
|
|
23
|
+
|
|
24
|
+
ENTRY_NAME = "vod-devkit"
|
|
25
|
+
|
|
26
|
+
# id → 探测目录 + 默认 MCP 配置文件(相对 HOME)
|
|
27
|
+
KNOWN_HOSTS = [
|
|
28
|
+
{"id": "claude-code", "paths": ["~/.claude", "~/.claude.json"],
|
|
29
|
+
"config": "~/.claude.json", "label": "Claude Code"},
|
|
30
|
+
{"id": "cursor", "paths": ["~/.cursor"],
|
|
31
|
+
"config": "~/.cursor/mcp.json", "label": "Cursor"},
|
|
32
|
+
{"id": "windsurf", "paths": ["~/.codeium/windsurf"],
|
|
33
|
+
"config": "~/.codeium/windsurf/mcp_config.json", "label": "Windsurf"},
|
|
34
|
+
{"id": "cline", "paths": ["~/.cline"],
|
|
35
|
+
"config": "~/.cline/mcp_settings.json", "label": "Cline"},
|
|
36
|
+
]
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def _expand(p: str) -> Path:
|
|
40
|
+
return Path(p).expanduser()
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
def detect_known() -> list:
|
|
44
|
+
"""探测在场但没有专属适配模块的宿主(只读,不写任何文件)。"""
|
|
45
|
+
found = []
|
|
46
|
+
for h in KNOWN_HOSTS:
|
|
47
|
+
if any(_expand(p).exists() for p in h["paths"]):
|
|
48
|
+
found.append(h)
|
|
49
|
+
return found
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def snippet(packs: str = "core,collect", api_base: str = "") -> dict:
|
|
53
|
+
"""可粘贴的 stdio 片段(安装器 no-path 时打印)。"""
|
|
54
|
+
args = type("A", (), {"java_api_base": api_base})()
|
|
55
|
+
entry = {"command": sys.executable, "args": [server_entry()],
|
|
56
|
+
"env": server_env(args, packs)}
|
|
57
|
+
return {"mcpServers": {ENTRY_NAME: entry}}
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def merge_mcp_servers(path: Path, entry: dict, name: str = ENTRY_NAME) -> str:
|
|
61
|
+
"""外科式合并 mcpServers 条目 → created / updated / unchanged。
|
|
62
|
+
|
|
63
|
+
现有文件非法 JSON 或不是对象时抛 RuntimeError(调用方拒绝安装,字节未动)。
|
|
64
|
+
"""
|
|
65
|
+
cfg = {}
|
|
66
|
+
existed = path.exists()
|
|
67
|
+
if existed:
|
|
68
|
+
raw = path.read_text(encoding="utf-8")
|
|
69
|
+
if raw.strip():
|
|
70
|
+
try:
|
|
71
|
+
parsed = json.loads(raw)
|
|
72
|
+
except json.JSONDecodeError as e:
|
|
73
|
+
raise RuntimeError(f"{path} 不是合法 JSON({e.msg}),拒绝改动") from e
|
|
74
|
+
if not isinstance(parsed, dict):
|
|
75
|
+
raise RuntimeError(f"{path} 顶层不是对象,拒绝改动")
|
|
76
|
+
cfg = parsed
|
|
77
|
+
servers = cfg.get("mcpServers")
|
|
78
|
+
if servers is None:
|
|
79
|
+
servers = {}
|
|
80
|
+
elif not isinstance(servers, dict):
|
|
81
|
+
raise RuntimeError(f"{path} 的 mcpServers 不是对象,拒绝改动")
|
|
82
|
+
if servers.get(name) == entry:
|
|
83
|
+
return "unchanged"
|
|
84
|
+
action = "updated" if servers.get(name) else "created"
|
|
85
|
+
if existed and action == "created":
|
|
86
|
+
shutil.copyfile(path, str(path) + ".bak")
|
|
87
|
+
servers[name] = entry
|
|
88
|
+
cfg["mcpServers"] = servers
|
|
89
|
+
path.parent.mkdir(parents=True, exist_ok=True)
|
|
90
|
+
path.write_text(json.dumps(cfg, ensure_ascii=False, indent=2) + "\n",
|
|
91
|
+
encoding="utf-8")
|
|
92
|
+
return action
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def install(args, packs):
|
|
96
|
+
"""无专属模块的宿主:合并到 --mcp-config 指定文件;未给路径则打印片段。"""
|
|
97
|
+
cfg_path = (getattr(args, "mcp_config", "") or "").strip()
|
|
98
|
+
detected = detect_known()
|
|
99
|
+
if not cfg_path:
|
|
100
|
+
if detected:
|
|
101
|
+
print("探测到通用 MCP 宿主:" + "、".join(h["label"] for h in detected)
|
|
102
|
+
+ "(本插件无专属适配,走通用写入)")
|
|
103
|
+
print(" 可用:--target generic --mcp-config " + detected[0]["config"])
|
|
104
|
+
print("未给 --mcp-config,不写任何文件。可粘贴片段(MCP 客户端通用):")
|
|
105
|
+
print(json.dumps(snippet(packs, args.java_api_base), ensure_ascii=False, indent=2))
|
|
106
|
+
print(" (技能目录未知,未安装技能;如需话术层请用 --target hermes|opencode|codex)")
|
|
107
|
+
return None
|
|
108
|
+
path = _expand(cfg_path)
|
|
109
|
+
entry = {"command": sys.executable, "args": [server_entry()],
|
|
110
|
+
"env": server_env(args, packs)}
|
|
111
|
+
action = merge_mcp_servers(path, entry)
|
|
112
|
+
verb = {"created": "写入", "updated": "更新", "unchanged": "跳过(已一致)"}[action]
|
|
113
|
+
print(f"已{verb} {path.name} 的 mcpServers.vod-devkit:{path}(重启宿主会话生效)")
|
|
114
|
+
return path
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def install_remote(args, url, token):
|
|
118
|
+
"""通用远程写入:headers 带 Bearer(明文,提示权限),其余键不动。"""
|
|
119
|
+
cfg_path = (getattr(args, "mcp_config", "") or "").strip()
|
|
120
|
+
if not cfg_path:
|
|
121
|
+
print("远程 attach 需要显式 --mcp-config <path>(通用宿主猜不出配置文件)",
|
|
122
|
+
file=sys.stderr)
|
|
123
|
+
sys.exit(2)
|
|
124
|
+
path = _expand(cfg_path)
|
|
125
|
+
entry = {"url": url, "headers": {"Authorization": f"Bearer {token}"}}
|
|
126
|
+
action = merge_mcp_servers(path, entry)
|
|
127
|
+
print(f"已写入通用远程 MCP 条目({action}):{path}(token 明文,注意文件权限)")
|
|
128
|
+
return path
|
|
129
|
+
|
|
130
|
+
|
|
131
|
+
def skills_dir(args):
|
|
132
|
+
return None
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
"""Hermes 宿主适配:官方 hermes mcp add + 路由插件部署。
|
|
2
|
+
|
|
3
|
+
落点与探测来自 integrations/hermes/host.json(数据驱动,代码里不许出现第二份
|
|
4
|
+
路径字面量);新增 Hermes 特定逻辑只改本模块。
|
|
5
|
+
"""
|
|
6
|
+
import json
|
|
7
|
+
import subprocess
|
|
8
|
+
import sys
|
|
9
|
+
from pathlib import Path
|
|
10
|
+
|
|
11
|
+
from vod_mcp import hosts as host_specs
|
|
12
|
+
from vod_mcp.host_adapters.base import ROOT, server_env, server_entry
|
|
13
|
+
|
|
14
|
+
HOST = "hermes"
|
|
15
|
+
SUPPORTS_REMOTE = True
|
|
16
|
+
_SPEC = host_specs.load("hermes")
|
|
17
|
+
_MCP_DIR = Path(_SPEC["configPath"]).parent
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def skills_dir(args):
|
|
21
|
+
return Path(_SPEC["skillsDir"])
|
|
22
|
+
|
|
23
|
+
|
|
24
|
+
def install(args, packs: str) -> Path:
|
|
25
|
+
"""Hermes:官方途径 hermes mcp add(config.yaml mcp_servers)。"""
|
|
26
|
+
conf = _MCP_DIR / "vod-devkit.json"
|
|
27
|
+
conf.parent.mkdir(parents=True, exist_ok=True)
|
|
28
|
+
conf.write_text(json.dumps({
|
|
29
|
+
"name": "vod-devkit", "command": sys.executable,
|
|
30
|
+
"args": [server_entry()], "env": server_env(args, packs),
|
|
31
|
+
}, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
32
|
+
env_args = []
|
|
33
|
+
for k, v in server_env(args, packs).items():
|
|
34
|
+
env_args.extend([k + "=" + v])
|
|
35
|
+
r = subprocess.run(
|
|
36
|
+
["hermes", "mcp", "add", "vod-devkit", "--command", sys.executable,
|
|
37
|
+
*["--env"] + env_args, "--args", server_entry()],
|
|
38
|
+
input="y\ny\n", capture_output=True, text=True)
|
|
39
|
+
# D-hook-1:强制评估路由插件(pre_llm_call 确定性意图路由,业界 forced-eval 模式)
|
|
40
|
+
import shutil as _sh
|
|
41
|
+
plug_src = ROOT / "hermes-plugin" / "vod-feedback-router"
|
|
42
|
+
plug_dst = Path.home() / ".hermes" / "plugins" / "vod-feedback-router"
|
|
43
|
+
if plug_src.is_dir():
|
|
44
|
+
if plug_dst.exists():
|
|
45
|
+
_sh.rmtree(plug_dst)
|
|
46
|
+
_sh.copytree(plug_src, plug_dst)
|
|
47
|
+
print("已安装 vod-feedback-router 路由插件(~/.hermes/plugins/);"
|
|
48
|
+
"需在 plugins.enabled 加入该名单后生效"
|
|
49
|
+
"(hermes config set plugins.enabled ...,重启会话生效)")
|
|
50
|
+
if r.returncode == 0:
|
|
51
|
+
print("已注册 Hermes MCP(hermes mcp list 可见;重启会话生效)")
|
|
52
|
+
else:
|
|
53
|
+
print(f"提示:hermes mcp add 未成功({r.stderr.strip()[:150]});"
|
|
54
|
+
f"可将 {conf} 内容并入 Hermes 配置")
|
|
55
|
+
return conf
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def install_remote(args, url, token):
|
|
59
|
+
"""hermes mcp add --url:token 经 env 注入,配置里只留 ${MCP_VOD_DEVKIT_API_KEY} 引用。"""
|
|
60
|
+
import os
|
|
61
|
+
env = os.environ.copy()
|
|
62
|
+
env["MCP_VOD_DEVKIT_API_KEY"] = token
|
|
63
|
+
r = subprocess.run(
|
|
64
|
+
["hermes", "mcp", "add", "vod-devkit", "--url", url, "--auth", "header"],
|
|
65
|
+
input="y\ny\n", capture_output=True, text=True, env=env, timeout=180)
|
|
66
|
+
if r.returncode != 0:
|
|
67
|
+
print(f"[vod-devkit] hermes mcp add(remote)失败:{(r.stderr or r.stdout).strip()[-200:]}",
|
|
68
|
+
file=sys.stderr)
|
|
69
|
+
sys.exit(1)
|
|
70
|
+
conf = _MCP_DIR / "vod-devkit.json"
|
|
71
|
+
conf.parent.mkdir(parents=True, exist_ok=True)
|
|
72
|
+
conf.write_text(json.dumps({"name": "vod-devkit", "url": url,
|
|
73
|
+
"headers": {"Authorization": "Bearer ${MCP_VOD_DEVKIT_API_KEY}"}},
|
|
74
|
+
ensure_ascii=False, indent=2), encoding="utf-8")
|
|
75
|
+
print(f"已注册 Hermes 远程 MCP({url};token 存 ~/.hermes/.env,配置内只留引用)")
|
|
76
|
+
return conf
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
"""OpenCode 宿主适配:opencode.json 的 mcp 段无损合并 + 随装生成物。"""
|
|
2
|
+
import sys
|
|
3
|
+
from pathlib import Path
|
|
4
|
+
|
|
5
|
+
from vod_mcp import hosts as host_specs
|
|
6
|
+
from vod_mcp.host_adapters.base import merge_json_mcp, server_env, server_entry
|
|
7
|
+
|
|
8
|
+
HOST = "opencode"
|
|
9
|
+
SUPPORTS_REMOTE = True
|
|
10
|
+
_SPEC = host_specs.load("opencode")
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
def skills_dir(args):
|
|
14
|
+
d = _SPEC.get("skillsDir")
|
|
15
|
+
return Path(d) if d else None
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
def install(args, packs: str) -> Path:
|
|
19
|
+
"""OpenCode:~/.config/opencode/opencode.json 的 mcp 段无损合并。
|
|
20
|
+
|
|
21
|
+
schema 实测要求:command=数组、enabled 必填;既有内容(provider 等)
|
|
22
|
+
原样保留(读改写,只动 mcp.vod-devkit 键)。
|
|
23
|
+
"""
|
|
24
|
+
spec = host_specs.load("opencode")
|
|
25
|
+
conf = Path(spec["configPath"])
|
|
26
|
+
entry = {
|
|
27
|
+
"type": "local",
|
|
28
|
+
"command": [sys.executable, server_entry()],
|
|
29
|
+
"enabled": True,
|
|
30
|
+
"environment": server_env(args, packs),
|
|
31
|
+
}
|
|
32
|
+
action = merge_json_mcp(conf, entry) # 公共合并件:保用户键 + 首改 .bak
|
|
33
|
+
print(f"已写入 OpenCode 配置({action}):{conf}(重启 OpenCode 会话生效)")
|
|
34
|
+
# 随装生成物走 integrations/opencode/ 的模板(单一来源——此前模板正文
|
|
35
|
+
# 硬编码在本函数里,改文案要同时改代码与文档两处)
|
|
36
|
+
for g in spec["generated"]:
|
|
37
|
+
dest = Path(g["dest"])
|
|
38
|
+
dest.parent.mkdir(parents=True, exist_ok=True)
|
|
39
|
+
dest.write_text(Path(g["template"]).read_text(encoding="utf-8"),
|
|
40
|
+
encoding="utf-8")
|
|
41
|
+
print(f"已写入 OpenCode 自检命令:/vod-doctor({dest})")
|
|
42
|
+
return conf
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
def install_remote(args, url, token):
|
|
46
|
+
"""mcp.vod-devkit = {type:remote, url, enabled, headers}(headers 明文,提示权限)。"""
|
|
47
|
+
conf = Path(_SPEC["configPath"])
|
|
48
|
+
entry = {"type": "remote", "url": url, "enabled": True,
|
|
49
|
+
"headers": {"Authorization": f"Bearer {token}"}}
|
|
50
|
+
action = merge_json_mcp(conf, entry)
|
|
51
|
+
print(f"已写入 OpenCode 远程 MCP 配置({action}):{conf}(token 随配置存放,注意文件权限)")
|
|
52
|
+
return conf
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
"""宿主适配层:每个宿主的路径/探测/生成物集中在 integrations/<host>/host.json。
|
|
2
|
+
|
|
3
|
+
动机(devkit 对表结论之一):新增宿主此前要在 1074 行的 bin 里改五处常量
|
|
4
|
+
与若干字面量路径,改漏一处就是"装了一半"。把**数据**(配置落点、技能目录、
|
|
5
|
+
平台差异、随装生成物)抽到 host.json,代码只保留每个宿主真正不同的安装
|
|
6
|
+
**逻辑**(hermes 走官方 CLI、opencode 走 JSON 合并、codex/dsh 走插件命令)。
|
|
7
|
+
|
|
8
|
+
纪律:
|
|
9
|
+
- host.json 里的路径一律相对 HOME 用 `~` 表示,由本模块解析;不许在代码里
|
|
10
|
+
出现第二份路径字面量。
|
|
11
|
+
- 平台差异用键名 "default"/"windows" 区分(当前只有 opencode 分叉)。
|
|
12
|
+
- `{profile}` 是 dsh 的占位符,必须由调用方显式代入(缺省不猜)。
|
|
13
|
+
"""
|
|
14
|
+
import json
|
|
15
|
+
import platform
|
|
16
|
+
from pathlib import Path
|
|
17
|
+
|
|
18
|
+
ROOT = Path(__file__).resolve().parent.parent
|
|
19
|
+
INTEGRATIONS = ROOT / "integrations"
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def hosts() -> list:
|
|
23
|
+
if not INTEGRATIONS.is_dir():
|
|
24
|
+
return []
|
|
25
|
+
return sorted(p.name for p in INTEGRATIONS.iterdir()
|
|
26
|
+
if (p / "host.json").exists())
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def _pick(value):
|
|
30
|
+
"""平台分叉取值:{"default": x, "windows": y} → 当前平台对应的字符串。"""
|
|
31
|
+
if isinstance(value, dict):
|
|
32
|
+
key = "windows" if platform.system() == "Windows" else "default"
|
|
33
|
+
return value.get(key, value.get("default"))
|
|
34
|
+
return value
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def _resolve(path_str, profile: str | None = None) -> Path:
|
|
38
|
+
if not isinstance(path_str, str) or not path_str:
|
|
39
|
+
raise ValueError("host.json 的路径配置缺失")
|
|
40
|
+
if "{profile}" in path_str:
|
|
41
|
+
if not profile:
|
|
42
|
+
raise ValueError(f"路径 {path_str} 需要 profile 名(dsh 按 profile 组织)")
|
|
43
|
+
path_str = path_str.replace("{profile}", profile)
|
|
44
|
+
if path_str.startswith("~"):
|
|
45
|
+
return Path.home() / path_str[2:] if path_str.startswith("~/") else Path.home()
|
|
46
|
+
return Path(path_str)
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def raw(host: str) -> dict:
|
|
50
|
+
"""读原始 host.json(不解析路径、不代入 profile)——探测/展示用。
|
|
51
|
+
|
|
52
|
+
动机(2026-11-11 实测):detect_targets 走 load() 时,dsh 的 configPath
|
|
53
|
+
含 {profile} 必填占位符 → ValueError,--target auto 在装了 dsh 集成后直接
|
|
54
|
+
崩。探测只需要 detectCLI/detectPath,不该被路径解析拖累。
|
|
55
|
+
"""
|
|
56
|
+
p = INTEGRATIONS / host / "host.json"
|
|
57
|
+
if not p.exists():
|
|
58
|
+
raise KeyError(f"未知宿主 {host}")
|
|
59
|
+
data = json.loads(p.read_text(encoding="utf-8"))
|
|
60
|
+
detect = data.get("detect") or {}
|
|
61
|
+
# 只补探测所需的两键(与 load() 同名);configPath 等仍留原始串,不解析
|
|
62
|
+
# {profile}——探测不该依赖安装期才有的输入。
|
|
63
|
+
data["detectCLI"] = detect.get("cli")
|
|
64
|
+
data["detectPath"] = (_resolve(_pick(detect["path"]))
|
|
65
|
+
if detect.get("path") else None)
|
|
66
|
+
return data
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def load(host: str, profile: str | None = None) -> dict:
|
|
70
|
+
"""读一个宿主的适配数据并解析成绝对路径 → dict(键为契约的一部分)。
|
|
71
|
+
|
|
72
|
+
返回键:id / cli / detectCLI / detectPath / configPath / skillsDir /
|
|
73
|
+
generated[{template, dest}] / managedPaths / notes
|
|
74
|
+
未知宿主抛 KeyError(调用方据此给"不支持目标"提示,不许静默降级)。
|
|
75
|
+
"""
|
|
76
|
+
p = INTEGRATIONS / host / "host.json"
|
|
77
|
+
if not p.exists():
|
|
78
|
+
raise KeyError(f"未知宿主 {host}(可选:{'、'.join(hosts())})")
|
|
79
|
+
raw = json.loads(p.read_text(encoding="utf-8"))
|
|
80
|
+
detect = raw.get("detect") or {}
|
|
81
|
+
spec = {
|
|
82
|
+
"id": raw.get("id") or host,
|
|
83
|
+
"cli": raw.get("cli"),
|
|
84
|
+
"detectCLI": detect.get("cli"),
|
|
85
|
+
"detectPath": (_resolve(_pick(detect["path"]), profile)
|
|
86
|
+
if detect.get("path") else None),
|
|
87
|
+
"configPath": (_resolve(_pick(raw["config"]), profile)
|
|
88
|
+
if raw.get("config") else None),
|
|
89
|
+
"skillsDir": (_resolve(_pick(raw["skillsDir"]), profile)
|
|
90
|
+
if raw.get("skillsDir") else None),
|
|
91
|
+
"generated": [
|
|
92
|
+
{"template": INTEGRATIONS / host / g["template"],
|
|
93
|
+
"dest": _resolve(_pick(g["dest"]), profile)}
|
|
94
|
+
for g in raw.get("generated") or []
|
|
95
|
+
],
|
|
96
|
+
"managedPaths": [_resolve(_pick(x), profile)
|
|
97
|
+
for x in raw.get("managedPaths") or []],
|
|
98
|
+
"notes": raw.get("notes") or "",
|
|
99
|
+
}
|
|
100
|
+
return spec
|
|
@@ -8,10 +8,14 @@ import sys
|
|
|
8
8
|
ALL_PACKS = ("core", "collect", "knowledge")
|
|
9
9
|
|
|
10
10
|
PACK_TOOLS = {
|
|
11
|
-
|
|
11
|
+
# vod_search_products:问用户"是哪个产品"前给候选(只读,D-product-ask-1)
|
|
12
|
+
"core": ["vod_devkit_info", "vod_auth_status", "vod_check_update",
|
|
13
|
+
"vod_search_products"],
|
|
12
14
|
# 两段式(D-token-approval-2 极简形态)随 collect 下发;codex 话术走 draft→commit
|
|
13
15
|
"collect": ["vod_submit_voices", "vod_draft_voices", "vod_commit_voices", "vod_list_submitted"],
|
|
14
|
-
|
|
16
|
+
# 领域规则技能披露(第二轨):知道有哪几本规则、按需取全文。
|
|
17
|
+
# 只读、零上游调用、零依赖——与"纯知识包"的定位一致。
|
|
18
|
+
"knowledge": ["vod_list_skills", "vod_retrieve_skill"],
|
|
15
19
|
}
|
|
16
20
|
|
|
17
21
|
|
|
@@ -44,8 +48,20 @@ def enabled_packs() -> tuple:
|
|
|
44
48
|
return packs
|
|
45
49
|
|
|
46
50
|
|
|
47
|
-
|
|
51
|
+
# 服务面(HTTP 传输)摘除的"写本机状态"工具——对齐 huaweicloud-devkit 的
|
|
52
|
+
# remoteSurface 门控语义:远程面没有"本机"这个概念。
|
|
53
|
+
# draft/commit:草稿暂存在本机 runtime.json,HTTP 面由多客户端共享一个进程,
|
|
54
|
+
# "本机草稿"既不隔离也不可审计;
|
|
55
|
+
# list_submitted:本地账本是装机维度的记录,服务面读它不是客户端想要的答案
|
|
56
|
+
# (跨机对账走引擎端点)。
|
|
57
|
+
# 注意:submit 不摘——它对 VOD 的唯一动作是调用引擎 HTTP API,落库是服务端的事。
|
|
58
|
+
REMOTE_WITHHELD = ("vod_draft_voices", "vod_commit_voices", "vod_list_submitted")
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def enabled_tools(remote: bool = False) -> list:
|
|
48
62
|
tools = []
|
|
49
63
|
for pack in enabled_packs():
|
|
50
64
|
tools.extend(PACK_TOOLS[pack])
|
|
65
|
+
if remote:
|
|
66
|
+
tools = [t for t in tools if t not in REMOTE_WITHHELD]
|
|
51
67
|
return tools
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
"""安装载荷(payload):把 server 与技能拷到宿主 / 用户自己的稳定目录。
|
|
2
|
+
|
|
3
|
+
动机(对标 huaweicloud-devkit 的 copyServerPayload,D-payload-1):
|
|
4
|
+
本仓所有 MCP 入口此前指向 `<repo>/vod_mcp/server.py`。用 npx 安装时 repo 在
|
|
5
|
+
`~/.npm/_npx/<hash>/`,npm 一旦清缓存/换版本,入口指向已删除的路径 —— 宿主
|
|
6
|
+
启动即 MCP 掉线,而用户看不到任何报错。
|
|
7
|
+
|
|
8
|
+
载荷模型就是它那套:
|
|
9
|
+
① 落一份稳定副本(默认 ~/.vod-devkit/payloads/<version>/)
|
|
10
|
+
② 入口指向副本,不指向 npx 缓存
|
|
11
|
+
③ 每次 install 覆盖 + prune 掉源里已不存在的旧条目(只删我们自己前缀的)
|
|
12
|
+
④ 落 `.installed` 标记 = "载荷已换,重启即生效";server 启动时自己删掉
|
|
13
|
+
⑤ payload.json 记录版本/commitSha/逐文件 sha256(doctor 与 verify 的依据)
|
|
14
|
+
|
|
15
|
+
与 devkit 的差别:零第三方依赖 → 不需要它的 installRuntimeDeps(npm install
|
|
16
|
+
undici 那一段);我们只校验 Python 版本与文件指纹。
|
|
17
|
+
"""
|
|
18
|
+
import hashlib
|
|
19
|
+
import json
|
|
20
|
+
import os
|
|
21
|
+
import shutil
|
|
22
|
+
import datetime
|
|
23
|
+
from pathlib import Path
|
|
24
|
+
|
|
25
|
+
ROOT = Path(__file__).resolve().parent.parent
|
|
26
|
+
|
|
27
|
+
def payload_home() -> Path:
|
|
28
|
+
"""载荷根(用户级,多宿主共享;版本目录隔离)。
|
|
29
|
+
|
|
30
|
+
每次读 env:测试用 VOD_PAYLOAD_HOME 重定向,进程内可随时改——
|
|
31
|
+
常量在 import 期求值会把测试写进真实 ~/.vod-devkit(第一版实锤)。
|
|
32
|
+
"""
|
|
33
|
+
return Path(os.environ.get("VOD_PAYLOAD_HOME") or (Path.home() / ".vod-devkit"))
|
|
34
|
+
|
|
35
|
+
# 我们拥有的顶层条目(prune 只在这个集合内动手,绝不碰用户文件)
|
|
36
|
+
OWNED = ("vod_mcp", "contract", "safety", "skills", "hermes-plugin",
|
|
37
|
+
"build-info.json", "payload.json", "package.json")
|
|
38
|
+
|
|
39
|
+
SKIP_DIRS = {"__pycache__"}
|
|
40
|
+
SKIP_FILES = {"runtime.json", "install-manifest.json", "payload.json"}
|
|
41
|
+
SKIP_SUFFIX = (".pyc", ".pyo", ".log")
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _sha256(path: Path) -> str:
|
|
45
|
+
h = hashlib.sha256()
|
|
46
|
+
with path.open("rb") as f:
|
|
47
|
+
for chunk in iter(lambda: f.read(1 << 20), b""):
|
|
48
|
+
h.update(chunk)
|
|
49
|
+
return h.hexdigest()
|
|
50
|
+
|
|
51
|
+
|
|
52
|
+
def _iter_files(src: Path):
|
|
53
|
+
for p in sorted(src.rglob("*")):
|
|
54
|
+
if p.is_dir():
|
|
55
|
+
continue
|
|
56
|
+
if any(part in SKIP_DIRS for part in p.parts):
|
|
57
|
+
continue
|
|
58
|
+
if p.name in SKIP_FILES or p.name.endswith(SKIP_SUFFIX):
|
|
59
|
+
continue
|
|
60
|
+
yield p
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
def payload_dir(version: str | None = None) -> Path:
|
|
64
|
+
from vod_mcp import __version__
|
|
65
|
+
return payload_home() / "payloads" / (version or __version__)
|
|
66
|
+
|
|
67
|
+
|
|
68
|
+
def marker_path() -> Path:
|
|
69
|
+
return payload_home() / ".installed"
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def file_hashes(base: Path) -> dict:
|
|
73
|
+
out = {}
|
|
74
|
+
for p in _iter_files(base):
|
|
75
|
+
out[str(p.relative_to(base)).replace(os.sep, "/")] = _sha256(p)
|
|
76
|
+
return out
|
|
77
|
+
|
|
78
|
+
|
|
79
|
+
def prune_stale(dest: Path, src_names: set) -> list:
|
|
80
|
+
"""删掉 dest 里我们拥有、但源里已不存在的顶层条目(升级不留残骸)。"""
|
|
81
|
+
removed = []
|
|
82
|
+
if not dest.exists():
|
|
83
|
+
return removed
|
|
84
|
+
for entry in sorted(dest.iterdir()):
|
|
85
|
+
if entry.name not in OWNED or entry.name in src_names:
|
|
86
|
+
continue
|
|
87
|
+
if entry.is_dir():
|
|
88
|
+
shutil.rmtree(entry)
|
|
89
|
+
else:
|
|
90
|
+
entry.unlink()
|
|
91
|
+
removed.append(entry.name)
|
|
92
|
+
return removed
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def stage(version: str | None = None, quiet: bool = False) -> Path:
|
|
96
|
+
"""把载荷拷进稳定目录(存在则原地刷新),返回载荷目录。"""
|
|
97
|
+
from vod_mcp import __version__
|
|
98
|
+
version = version or __version__
|
|
99
|
+
dest = payload_dir(version)
|
|
100
|
+
dest.mkdir(parents=True, exist_ok=True)
|
|
101
|
+
|
|
102
|
+
sources = {"vod_mcp": ROOT / "vod_mcp", "contract": ROOT / "contract",
|
|
103
|
+
"safety": ROOT / "safety", "skills": ROOT / "skills",
|
|
104
|
+
"hermes-plugin": ROOT / "hermes-plugin"}
|
|
105
|
+
for name, src in sources.items():
|
|
106
|
+
if not src.is_dir():
|
|
107
|
+
continue # hermes-plugin 可缺(非 hermes 宿主)
|
|
108
|
+
target = dest / name
|
|
109
|
+
target.mkdir(parents=True, exist_ok=True)
|
|
110
|
+
for f in _iter_files(src):
|
|
111
|
+
rel = f.relative_to(src)
|
|
112
|
+
out = target / rel
|
|
113
|
+
out.parent.mkdir(parents=True, exist_ok=True)
|
|
114
|
+
shutil.copyfile(f, out)
|
|
115
|
+
|
|
116
|
+
# 顶层单体文件
|
|
117
|
+
for name in ("build-info.json", "package.json"):
|
|
118
|
+
src = ROOT / name
|
|
119
|
+
if src.exists():
|
|
120
|
+
shutil.copyfile(src, dest / name)
|
|
121
|
+
|
|
122
|
+
removed = prune_stale(dest, set(sources) | {"build-info.json", "package.json",
|
|
123
|
+
"payload.json"})
|
|
124
|
+
|
|
125
|
+
info = json.loads((ROOT / "build-info.json").read_text(encoding="utf-8")) \
|
|
126
|
+
if (ROOT / "build-info.json").exists() else {}
|
|
127
|
+
manifest = {
|
|
128
|
+
"version": version,
|
|
129
|
+
"commitSha": info.get("commitSha"),
|
|
130
|
+
"stagedAt": datetime.datetime.now().isoformat(timespec="seconds"),
|
|
131
|
+
"files": file_hashes(dest),
|
|
132
|
+
}
|
|
133
|
+
(dest / "payload.json").write_text(
|
|
134
|
+
json.dumps(manifest, ensure_ascii=False, indent=2), encoding="utf-8")
|
|
135
|
+
marker_path().parent.mkdir(parents=True, exist_ok=True)
|
|
136
|
+
marker_path().write_text(datetime.datetime.now().isoformat(timespec="seconds"),
|
|
137
|
+
encoding="utf-8")
|
|
138
|
+
if not quiet:
|
|
139
|
+
print(f"载荷已就位:{dest}({len(manifest['files'])} 个文件"
|
|
140
|
+
+ (f";清理旧条目 {removed}" if removed else "") + ")")
|
|
141
|
+
return dest
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def consume_marker() -> None:
|
|
145
|
+
"""server 启动时调用:标记只表示"换过载荷,该重启",被运行中的进程消费掉。"""
|
|
146
|
+
try:
|
|
147
|
+
marker_path().unlink(missing_ok=True)
|
|
148
|
+
except Exception:
|
|
149
|
+
pass
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def verify(payload: Path) -> list:
|
|
153
|
+
"""比对 payload.json 的逐文件 sha256,返回问题清单(空=OK)。"""
|
|
154
|
+
problems = []
|
|
155
|
+
pj = payload / "payload.json"
|
|
156
|
+
if not pj.exists():
|
|
157
|
+
return [f"载荷缺 payload.json:{payload}"]
|
|
158
|
+
data = json.loads(pj.read_text(encoding="utf-8"))
|
|
159
|
+
for rel, sha in (data.get("files") or {}).items():
|
|
160
|
+
f = payload / rel
|
|
161
|
+
if not f.exists():
|
|
162
|
+
problems.append(f"载荷文件缺失:{rel}")
|
|
163
|
+
elif _sha256(f) != sha:
|
|
164
|
+
problems.append(f"载荷文件被改:{rel}")
|
|
165
|
+
return problems
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
def residue() -> list:
|
|
169
|
+
"""没有 payload.json 的载荷目录 = 残留(旧版本/手工拷贝),doctor 报出来。"""
|
|
170
|
+
base = payload_home() / "payloads"
|
|
171
|
+
if not base.is_dir():
|
|
172
|
+
return []
|
|
173
|
+
return [p for p in sorted(base.iterdir())
|
|
174
|
+
if p.is_dir() and not (p / "payload.json").exists()]
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
"""远程面(Streamable HTTP)的服务实例:与 devkit 同构,工具面从契约派生。
|
|
2
|
+
|
|
3
|
+
三处与 devkit 对齐、一处按我们自己的边界收紧:
|
|
4
|
+
|
|
5
|
+
对齐:
|
|
6
|
+
- 官方 SDK 的 Streamable HTTP 传输(StreamableHTTPSessionManager,stateless +
|
|
7
|
+
json_response),一个进程服务多个 agent;
|
|
8
|
+
- 工具面由 remoteSurface 语义门控:摘掉"写本机状态"的工具(草稿/本地账本),
|
|
9
|
+
保留调引擎 API 的 submit;
|
|
10
|
+
- initialize 的 instructions 换一版,明说远程面不给服务器本机路径(skillRoot
|
|
11
|
+
等价物),规则文本请走 vod_retrieve_skill。
|
|
12
|
+
|
|
13
|
+
收紧:
|
|
14
|
+
- **身份只从请求头来**。插件不代签、不落盘;缺 Authorization 时 submit 直接
|
|
15
|
+
结构化拒绝(匿名令牌按设备锚点签发,服务面一进程一锚点会把配额/声量/归因
|
|
16
|
+
搅在一起)。这是与 devkit 的实质差异:它的远程面不管身份,我们的写面必须管。
|
|
17
|
+
|
|
18
|
+
插件不写库:本进程对 VOD 的全部动作仍然是调用引擎 HTTP API。
|
|
19
|
+
"""
|
|
20
|
+
import asyncio
|
|
21
|
+
import json
|
|
22
|
+
|
|
23
|
+
from mcp import types
|
|
24
|
+
from mcp.server.lowlevel import Server
|
|
25
|
+
|
|
26
|
+
from vod_mcp import guardrails, packs, skills_registry, tools
|
|
27
|
+
|
|
28
|
+
REMOTE_INSTRUCTIONS = (
|
|
29
|
+
"vod-devkit 采集资产与纪律(远程面):技能 vod-feedback-collect 处理用户对"
|
|
30
|
+
"本产品的不满/建议/期望(触发词:慢/报错/体验差/希望支持/提单等)。"
|
|
31
|
+
"提交前必须征得用户明确同意(用户抱怨本身不构成同意);提交回执 "
|
|
32
|
+
"echo.contents 必须逐条原样转述给用户(「已收录原话:<content>」),"
|
|
33
|
+
"禁止改写、概括、增删字词。product 归因由部署绑定决定,禁止询问用户。"
|
|
34
|
+
"本面不提供服务器本机路径(skillRoot),规则文本用 vod_retrieve_skill 取;"
|
|
35
|
+
"写本机状态的工具(草稿/本地账本)不在本面提供。"
|
|
36
|
+
)
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def _text_result(payload: dict, is_error: bool = False) -> types.CallToolResult:
|
|
40
|
+
return types.CallToolResult(
|
|
41
|
+
content=[types.TextContent(type="text",
|
|
42
|
+
text=json.dumps(payload, ensure_ascii=False))],
|
|
43
|
+
structured_content=payload,
|
|
44
|
+
is_error=is_error)
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
class _RemoteServer(Server):
|
|
48
|
+
"""把 capabilities 对齐 devkit:{tools:{listChanged:true}}。
|
|
49
|
+
|
|
50
|
+
Python SDK 的默认 NotificationOptions 给 listChanged=false;devkit 的
|
|
51
|
+
remote test 明确断言 {tools: {listChanged: true}}。工具面由 pack 门控且
|
|
52
|
+
本面 stateless,listChanged 只是信息性声明,但既然参照物声明了 true,就照它。
|
|
53
|
+
"""
|
|
54
|
+
|
|
55
|
+
def create_initialization_options(self, *args, **kwargs): # noqa: D401
|
|
56
|
+
from mcp.server.lowlevel.server import NotificationOptions
|
|
57
|
+
kwargs.setdefault("notification_options", NotificationOptions(tools_changed=True))
|
|
58
|
+
return super().create_initialization_options(*args, **kwargs)
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def build_server(remote: bool = True) -> Server:
|
|
62
|
+
version = tools.load_contract()["version"]
|
|
63
|
+
|
|
64
|
+
async def on_list_tools(ctx, params):
|
|
65
|
+
specs = tools.tool_specs(packs.enabled_tools(remote=remote))
|
|
66
|
+
return types.ListToolsResult(tools=[
|
|
67
|
+
types.Tool(name=s["name"], description=s["description"],
|
|
68
|
+
input_schema=s["inputSchema"]) for s in specs])
|
|
69
|
+
|
|
70
|
+
async def on_call_tool(ctx, params):
|
|
71
|
+
name = params.name
|
|
72
|
+
args = params.arguments or {}
|
|
73
|
+
if remote and name in packs.REMOTE_WITHHELD:
|
|
74
|
+
return _text_result({
|
|
75
|
+
"error": f"[remote] {name} 不在服务面提供",
|
|
76
|
+
"reason": ("该工具写本机状态(草稿/本地账本),远程面没有「本机」概念。"
|
|
77
|
+
"跨机对账请走引擎端点;两段式请改用 stdio 形态。"),
|
|
78
|
+
}, is_error=True)
|
|
79
|
+
verdict, msg, code = guardrails.check(name, args)
|
|
80
|
+
if verdict != "allow":
|
|
81
|
+
return _text_result({"error": msg, "code": code}, is_error=True)
|
|
82
|
+
client_info = {"name": "http-remote", "version": "1", "transport": "http"}
|
|
83
|
+
try:
|
|
84
|
+
out = await asyncio.to_thread(tools.dispatch, name, args, client_info)
|
|
85
|
+
except tools.ToolError as e:
|
|
86
|
+
return _text_result({"error": str(e), "code": e.code}, is_error=True)
|
|
87
|
+
if remote and name == "vod_list_skills":
|
|
88
|
+
out.pop("skillsDir", None) # 服务面不发布本机目录
|
|
89
|
+
return _text_result(out)
|
|
90
|
+
|
|
91
|
+
return _RemoteServer(
|
|
92
|
+
name="vod-devkit",
|
|
93
|
+
version=version,
|
|
94
|
+
instructions=REMOTE_INSTRUCTIONS if remote else None,
|
|
95
|
+
on_list_tools=on_list_tools,
|
|
96
|
+
on_call_tool=on_call_tool,
|
|
97
|
+
)
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
__all__ = ["build_server", "REMOTE_INSTRUCTIONS", "skills_registry"]
|