管理 Agent Adapter
校验、安装和管理租户隔离的声明式 Agent Adapter 与 Workspace 配置模板。
管理 Agent Adapter
Agent Adapter 是一个声明式、不可变的 Agent 集成定义。它描述所需 Sandbox template、运行时、 能力、交互模式、持久路径和凭据类型；Appaloft 不会从 manifest 加载代码，也不接受 shell command 字符串。
每次安装都属于当前组织。两个组织可以安装相同 digest 的定义，但不能看到或操作彼此的安装。 组织成员可以查看安装；组织管理员可以校验、安装、停用和卸载。
准备 manifest
下面的 manifest 展示最小的 Codex terminal/headless 适配方式。把 template id、版本、digest 和 runtime 版本范围替换成当前 Appaloft 实例已经准入的值。
{
"schemaVersion": "appaloft.agent-adapter/v1",
"id": "codex",
"displayName": "Codex",
"version": "1.0.0",
"kind": "declarative",
"requirements": {
"adapterApi": "^1.0.0",
"sandboxTemplate": {
"id": "agent-workspace",
"version": "^1.0.0",
"digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
},
"runtimes": [{ "id": "codex", "version": "^1.0.0" }],
"capabilities": {
"required": ["managed-terminal", "headless"],
"optional": []
}
},
"interactionModes": [
{
"id": "terminal",
"transport": "terminal",
"command": ["codex"],
"eventFidelity": "raw-pty",
"sessionRecovery": "process-lifetime"
},
{
"id": "headless",
"transport": "headless",
"command": ["codex", "exec"],
"taskInput": "append-argument",
"eventFidelity": "line-events",
"sessionRecovery": "managed-run-lineage"
}
],
"persistentPaths": ["/workspace/.codex"],
"healthcheck": { "kind": "process" },
"credentials": []
}校验只返回规范化后的 digest 和兼容性结果，不会持久化数据或启动 Agent：
appaloft agent-adapter validate ./codex.agent-adapter.json
appaloft agent-adapter install ./codex.agent-adapter.json
appaloft agent-adapter list
appaloft agent-adapter show <installation-id>也可以在 Web 控制台的“组织设置 → Agent Adapter”粘贴 manifest、先校验再安装。
安装 Workspace 配置模板
Workspace 配置模板把一个精确的 Adapter definition、Sandbox template、运行限制、初始化命令、 默认端口和检查命令组合成可复用入口。它不会执行安装脚本，也不会创建新的 Workspace aggregate。 创建 Workspace 前，Appaloft 会编译模板并把解析出的 Adapter digest、Sandbox template digest、 Harness 和 capability snapshot 固定到 Runtime。
{
"schemaVersion": "appaloft.agent-workspace-profile/v1",
"id": "codex-standard",
"displayName": "Codex Standard",
"version": "1.0.0",
"adapter": {
"id": "codex",
"version": "1.0.0",
"digest": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"interactiveModeId": "terminal",
"taskModeId": "headless"
},
"harnessTemplateId": "aht_codex_declarative_v1",
"sandbox": {
"template": {
"id": "agent-workspace",
"version": "1.0.0",
"digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111"
},
"requestedIsolation": "container-trusted",
"limits": {
"cpuMillis": 2000,
"memoryBytes": 4294967296,
"diskBytes": 21474836480,
"maxProcesses": 128
},
"networkPolicy": { "mode": "deny" }
},
"workingDirectory": "/workspace",
"initialization": [{ "id": "verify-codex", "argv": ["codex", "--version"] }],
"defaultPorts": [],
"persistentPaths": ["/workspace/.codex"],
"suggestedChecks": []
}appaloft agent-workspace-profile validate ./codex.profile.json
appaloft agent-workspace-profile install ./codex.profile.json
appaloft agent-workspace-profile list
appaloft agent-workspace-profile compile <installation-id>组织管理员可以在“组织设置 → Workspace 配置模板”完成相同操作。开发者在 Workspaces 页面选择 一个已启用的模板后创建 Workspace；不可用的 capability 会让对应按钮保持禁用，而不是在创建后 静默降级。
停用和卸载
停用阻止新 Workspace 解析该安装，但不会破坏已有 Workspace 的恢复引用：
appaloft agent-adapter disable <installation-id>只有没有 active Workspace 引用时才能卸载。存在引用时，服务端返回冲突并保留安装：
appaloft agent-adapter uninstall <installation-id>卸载只删除当前组织的安装记录，不删除可由其他组织共享的不可变 definition，也不终止已有 Sandbox 或 Agent 进程。
Workspace 配置模板使用相同的停用和引用保护语义：
appaloft agent-workspace-profile disable <installation-id>
appaloft agent-workspace-profile uninstall <installation-id>