Imported from 843773493/vscode-graph-agent-opencode (
tests/integration/workspace_services/AGENTS.md). Install upstream withnpx skills add 843773493/vscode-graph-agent-opencode --skill workspace_services. Copyright stays with the author.
目录用途
存放 Browser、Terminal、MCP 等辅助服务与替身外部边界组合的集成测试。
workspace_services/
├── test_gateway_resource_shutdown.py Gateway整组关闭与资源回收，模型使用显式回放替身
├── browser/ Browser Manager 与受控页面、网络及进程组合
├── terminal/ Terminal 模块与受控系统进程、信号及回收行为
└── mcp/ MCP 客户端与受控协议服务的交互按被测辅助服务选择目录；纯解析和状态计算留在对应模块的单元测试，经过完整用户入口的流程归 E2E。
整组关闭测试复用现有 model_stream 资产及精确 SessionThread/ModelCall 回放，由真实 Session 和消息 API 生成执行状态；受控 composition 只提供 ID 和观察端口。Chat/Responses 均核对原 Job 期限、实际回复及 owner，资源和进程回收仍由真实关闭入口证明。共享资产的真实 HTTP、同步和异步 SDK 验证归 integration/harness/test_model_http_assets.py，业务关闭场景不再持有模型 socket。
同一测试的shutdown_environment只临时改写本次隔离工作区配置，并用目录fd提供Unix socket所需的短临时路径：写入前登记原字节恢复，打开fd后立即登记关闭，短路径核验也在释放范围内。准备失败、测试失败或fd关闭失败仍尝试恢复配置，异常沿标准退出栈保留；不改用户服务环境或持久配置。
test_resource_orphan_sweep.py复用现有双辅助服务fixture，经正式Session、Terminal/Browser创建/detach、原孤儿回收与显式管理核实，验证同批peer在首项回执等待中完成真实删除，原30秒预算跨撤权和删除回执保持唯一；删除已落盘但Python未收到回执时保留unknown/原lease，核实只对账且不重发删除。通过 bun run test:matrix -- --suite=integration-resource-orphan-sweep 运行，固定120秒/4GiB；真实Node、PTY/Chromium与HTTP不替代Gateway/Web、Windows、不合作操作终止或完整shutdown验收。
可修改内容
- 真实辅助服务模块、测试页面服务、mini MCP 和明确协议替身的组合测试。
不可修改内容
- 不要把这些用例标记为 E2E 或依赖用户真实工作区。
规范
- 目录名使用 Python 可导入的
workspace_services。 - 替身边界必须在测试名、fixture 或代码中显式可见。
test_resource_release.py沿正式Session、资源创建、operation及原Session资源drain生成状态，复用双辅助服务fixture。真实PTY/Chromium/HTTP核全量lease冲突不部分detach、peer完成后可查询、一次30秒覆盖撤权与删除回执、原lease及同入口核实不重发删除；suite integration-resource-release固定120秒/4GiB。Thread入口由共享owner单测验证，不把该场景称为整个Session删除、runtime卸载、Gateway/Web或Windows验收。
