JiuwenSwarm is an intelligent AI Agent built on openJiuwen. It extends the powerful capabilities of large language models directly to your fingertips through various communication apps you use daily.
Python
# Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.
"""spawn_fallback 权限挂起保全与 interrupt 结果识别的回归测试。
- ``_suspend_subagent_permission_rails`` 挂起时只应翻转 enabled,不得清空
tools/file_guard(agent-core update_config 是整体替换语义);并同步替换
``host.get_permissions_snapshot``,避免 resolve_interrupt 用旧快照刷回。
- interrupt result(``result_type == "interrupt"``)无 output 字段,
``spawn_fallback`` 应显式报错而非吞成空输出。
"""
from __future__ import annotations
from typing import Any
import pytest
from jiuwenswarm.server.runtime.agent_adapter.interface_deep import (
JiuWenSwarmDeepAdapter,
)
from jiuwenswarm.server.runtime.agent_adapter.deep.rail_factory import _suspend_subagent_permission_rails
class _FakeHost:
def __init__(self) -> None:
self.get_permissions_snapshot = lambda: {"enabled": True}
class PermissionInterruptRail: # noqa: N801
"""最小权限 rail 替身:复现整体替换语义的 update_config。
类名必须与生产匹配逻辑(cls.__name__ 白名单)一致,否则会被跳过。
"""
def __init__(self, config: dict[str, Any]) -> None:
self._static_config = dict(config)
self.engine_config = dict(config)
self._host = _FakeHost()
def update_config(self, config: dict[str, Any]) -> None:
cfg = dict(config)
self._static_config = cfg
self.engine_config = cfg
class _FakeSubagent:
def __init__(self, rails: list[Any]) -> None:
self._rails = rails
def configured_rails(self) -> list[Any]:
return list(self._rails)
def test_suspend_preserves_full_config_only_flips_enabled() -> None:
"""挂起只翻转 enabled,tools/file_guard 必须保留在引擎配置中。"""
rail = PermissionInterruptRail(
{
"enabled": True,
"tools": {"web_search": "allow", "skill_acceleration_exec": "ask"},
"file_guard": {"workspace": {"read": "allow"}},
}
)
subagent = _FakeSubagent([rail])
restore = _suspend_subagent_permission_rails(subagent)
assert rail.engine_config["enabled"] is False
assert rail.engine_config["tools"] == {
"web_search": "allow",
"skill_acceleration_exec": "ask",
}
assert rail.engine_config["file_guard"] == {"workspace": {"read": "allow"}}
def test_suspend_patches_host_snapshot_to_disabled_full_config() -> None:
"""挂起同步替换 host.get_permissions_snapshot,避免 resolve_interrupt 用旧快照刷回。"""
rail = PermissionInterruptRail(
{
"enabled": True,
"tools": {"web_search": "allow"},
"file_guard": {"workspace": {"read": "allow"}},
}
)
subagent = _FakeSubagent([rail])
original_snapshot = rail._host.get_permissions_snapshot
restore = _suspend_subagent_permission_rails(subagent)
assert rail.engine_config["enabled"] is False
assert rail._host.get_permissions_snapshot() == {
"enabled": False,
"tools": {"web_search": "allow"},
"file_guard": {"workspace": {"read": "allow"}},
}
restore()
assert rail._host.get_permissions_snapshot is original_snapshot
assert rail._host.get_permissions_snapshot() == {"enabled": True}
def test_suspend_restore_returns_original_config() -> None:
"""恢复后:引擎配置与 host snapshot 都回到挂起前。"""
original = {
"enabled": True,
"tools": {"web_search": "allow"},
}
rail = PermissionInterruptRail(original)
subagent = _FakeSubagent([rail])
restore = _suspend_subagent_permission_rails(subagent)
restore()
assert rail.engine_config == original
assert rail._host.get_permissions_snapshot() == {"enabled": True}
def test_suspend_includes_flash_permission_rail() -> None:
"""FlashPermissionRail 在 suspendable 白名单内。"""
class FlashPermissionRail: # noqa: N801 — 匹配生产白名单类名
def __init__(self, config: dict[str, Any]) -> None:
self._static_config = dict(config)
self.engine_config = dict(config)
def update_config(self, config: dict[str, Any]) -> None:
self._static_config = dict(config)
self.engine_config = dict(config)
rail = FlashPermissionRail({"enabled": True, "tools": {"cron_flash": "ask"}})
subagent = _FakeSubagent([rail])
restore = _suspend_subagent_permission_rails(subagent)
assert rail.engine_config["enabled"] is False
assert rail.engine_config["tools"] == {"cron_flash": "ask"}
restore()
assert rail.engine_config["enabled"] is True
def test_suspend_ignores_unrelated_rails() -> None:
"""非权限类 rail 不参与挂起(保持既有行为)。"""
class _OtherRail:
pass
other = _OtherRail()
subagent = _FakeSubagent([other])
restore = _suspend_subagent_permission_rails(subagent)
restore() # 无权限 rail 时恢复为 no-op,不应报错
class _FakeInstance:
def __init__(self) -> None:
self.created: list[tuple[str, str]] = []
def create_subagent(self, kind: str, session_id: str) -> Any:
self.created.append((kind, session_id))
return _FakeSubagent([])
def _make_adapter() -> JiuWenSwarmDeepAdapter:
"""spawn_fallback 仅依赖 self._instance;绕过重型 __init__。"""
adapter = object.__new__(JiuWenSwarmDeepAdapter)
adapter._instance = _FakeInstance()
return adapter
@pytest.mark.asyncio
async def test_spawn_fallback_raises_on_interrupt_result(monkeypatch) -> None:
"""子代理以未解决的 HITL interrupt 结束时必须显式报错,不得吞成空输出。"""
async def _fake_invoke(
subagent: Any, *, inputs: dict, session: Any, source_label: str
) -> dict:
# 复现 agent-core build_interrupt_result 的形状:无 output 字段
return {"result_type": "interrupt", "state": [], "interrupt_ids": ["perm-1"]}
monkeypatch.setattr(
"jiuwenswarm.server.runtime.debug_trace.invoke_subagent_with_trace",
_fake_invoke,
)
adapter = _make_adapter()
with pytest.raises(RuntimeError, match="HITL interrupt"):
await adapter.spawn_fallback("请生成 PPT 内容策划")
@pytest.mark.asyncio
async def test_spawn_fallback_returns_output_normally(monkeypatch) -> None:
"""正常结果(含 output)不受影响:返回输出文本(不得回归)。"""
async def _fake_invoke(
subagent: Any, *, inputs: dict, session: Any, source_label: str
) -> dict:
return {"output": "节点执行完成", "result_type": "done"}
monkeypatch.setattr(
"jiuwenswarm.server.runtime.debug_trace.invoke_subagent_with_trace",
_fake_invoke,
)
adapter = _make_adapter()
output = await adapter.spawn_fallback("请生成 PPT 内容策划")
assert output == "节点执行完成"