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.
"""flash 模式工具面单元测试:rail 白名单、react 覆盖、统一 todo / memory 工具。"""
from __future__ import annotations
import logging
from types import SimpleNamespace
import pytest
from openjiuwen.core.foundation.store.base_embedding import EmbeddingConfig
from jiuwenswarm.agents.harness.common.memory.config import (
is_agent_mode,
is_memory_enabled,
is_proactive_memory,
)
from jiuwenswarm.agents.harness.flash import (
FlashMemoryRail,
FlashMemoryTool,
UnifiedTodoTool,
)
from jiuwenswarm.server.runtime.agent_adapter.interface_deep import (
JiuWenSwarmDeepAdapter,
_RailBuildInfo,
)
from jiuwenswarm.server.runtime.agent_adapter import interface_flash
from jiuwenswarm.server.runtime.agent_adapter.interface_flash import (
JiuwenSwarmFlashAdapter,
)
def _bare_adapter(cls) -> object:
"""Bare adapter carrying no initialized state (class-level behavior only)."""
return object.__new__(cls)
class _StubTodoEngine:
"""Records forwarded inputs/kwargs in place of a stock Todo engine."""
def __init__(self) -> None:
self.calls: list[tuple[dict, dict]] = []
async def invoke(self, inputs: dict, **kwargs):
self.calls.append((inputs, kwargs))
return {"ok": True}
class _FakeAbilityManager:
"""Registry double keyed by ability name."""
def __init__(self) -> None:
self.tools: dict[str, object] = {}
self.adds: list[str] = []
def get(self, name: str):
return self.tools.get(name)
def add_ability(self, card, tool):
self.tools[card.name] = card
self.adds.append(card.name)
return SimpleNamespace(added=True)
# ── rail 白名单 ──────────────────────────────────────────────────────
def test_keep_whitelist_retains_skill_and_security_rails() -> None:
"""技能链、受限自演进与 disabled_tools 的冷启动表项必须存活。"""
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
keep = [
"_skill_rail",
"_skill_credential_injection_rail",
"_skill_active_state_rail",
"_skill_authorization_rail",
"_skill_evolution_rail",
"_evolution_interrupt_rail",
"_skill_sleep_rail",
"_disabled_tools_rail",
"_permission_rail",
"_filesystem_rail",
"_skill_turbo_prompt_rail",
]
drop = [
"_skill_create_rail",
"_a2a_outbound_toolkit_rail",
"_symphony_orchestration_rail",
]
infos = [_RailBuildInfo(name, lambda: None) for name in keep + drop]
filtered = adapter._filter_rail_infos_by_keep(infos)
assert [info.attr_name for info in filtered] == keep
def test_flash_tool_face_keeps_rail_owned_evolution_tools_only() -> None:
"""Flash accepts the six rail-owned evolution tools, not SkillCreate/TTSE."""
drop_names = JiuwenSwarmFlashAdapter._FLASH_TOOL_CARD_DROP_NAMES
rail_owned_evolution_tools = {
"prepare_skill_evolution",
"evolve_review_task",
"list_skill_experiences",
"read_skill_experiences",
"evolve_skill_experiences",
"simplify_skill_experiences",
}
keep = JiuwenSwarmFlashAdapter._FLASH_RAIL_KEEP
assert rail_owned_evolution_tools.isdisjoint(drop_names)
assert "_skill_create_rail" not in keep
assert "_ttse_rail" not in keep
# ── react 覆盖(eager_tools 整表替换 / evolution 深合并 / env 告警) ──
def test_react_override_replaces_eager_tools_and_keeps_siblings() -> None:
"""eager_tools 整表替换为 flash 名单,部署自有键与兄弟子树保留。"""
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
config_base = {
"react": {
"enable_task_loop": True,
"tool_lazy_load": {
"enabled": True,
"eager_tools": ["web_search", "list_files", "todo_create"],
"subagents": {"enabled": True},
},
"evolution": {"skill_create": True, "extra_key": "keep_me"},
}
}
react = adapter._apply_flash_react_override(config_base)["react"]
assert react["enable_task_loop"] is False
lazy = react["tool_lazy_load"]
# Flash override is the source of truth for flash; config.yaml's
# react.tool_lazy_load.eager_tools covers the non-flash deep path.
assert lazy["eager_tools"] == [
"web_search",
"fetch_webpage",
"ask_user",
"read_file",
"write_file",
"edit_file",
"glob",
"grep",
"bash",
"skill_tool",
"skill_complete",
"todo",
"office_claw_list_wishes",
]
assert lazy["enabled"] is True
assert lazy["subagents"] == {"enabled": True}
assert react["evolution"]["skill_create"] is False
assert react["evolution"]["extra_key"] == "keep_me"
def test_evolution_env_bypass_warns(monkeypatch: pytest.MonkeyPatch) -> None:
"""env 级开关翻回 true 时必须告警(task_loop 有被 force-revive 的风险)。"""
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
monkeypatch.setattr(
"jiuwenswarm.server.runtime.agent_adapter.interface_flash.get_skill_create_enabled",
lambda config: True,
)
# 仓库的 setup_logger()(common/utils.py 模块级调用)把 jiuwenswarm 命名空间
# logger 置为 propagate=False,告警到不了 root;caplog 只挂 root,旧版
# pytest 不补挂非传播 logger。直接在模块 logger 上捕获,不依赖传播行为。
captured: list[str] = []
class _CaptureHandler(logging.Handler):
def emit(self, record: logging.LogRecord) -> None:
captured.append(record.getMessage())
handler = _CaptureHandler()
interface_flash.logger.addHandler(handler)
try:
adapter._apply_flash_react_override({"react": {}})
finally:
interface_flash.logger.removeHandler(handler)
assert any("SKILL_CREATE" in message for message in captured)
# ── 技能模式 / 工具卡裁剪 ────────────────────────────────────────────
def test_skill_mode_pinned_all() -> None:
"""flash 钉死 ALL:auto_list 配置也不注册 ListSkillTool。"""
assert (
JiuwenSwarmFlashAdapter._resolve_skill_mode({"skill_mode": "auto_list"}) == "all"
)
def test_tool_face_override_without_deep_hooks() -> None:
"""工具面裁剪全部由 flash 的 _get_tool_cards 覆盖承载,DeepAdapter 不新增钩子。"""
assert not hasattr(JiuWenSwarmDeepAdapter, "_tool_card_drop_names")
assert not hasattr(JiuWenSwarmDeepAdapter, "_build_skill_toolkit")
assert JiuwenSwarmFlashAdapter._FLASH_TOOL_CARD_DROP_NAMES == frozenset({
"wiki_ingest",
"wiki_query",
"wiki_lint",
"acp_chat",
"search_skill",
"install_skill",
"uninstall_skill",
})
def _visibility_env(**perm):
"""set 权限上下文,返回裸 adapter/桩 am/桩 rail/状态列表/reset 闭包。"""
from jiuwenswarm.agents.harness.common.rails.permissions.owner_scopes import (
PermissionContext,
TOOL_PERMISSION_CONTEXT,
)
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
am = SimpleNamespace(removed=[])
am.remove = lambda name: am.removed.append(name)
rail_state: list = []
rail = SimpleNamespace(
set_read_only=lambda value: rail_state.append(value),
restore_memory_tool=lambda agent: rail_state.append("restore"),
)
adapter._instance = SimpleNamespace(ability_manager=am)
adapter._memory_rail = rail
defaults = dict(
channel_id="ch",
enable_memory=True,
group_digital_avatar=False,
avatar_mode=False,
)
defaults.update(perm)
token = TOOL_PERMISSION_CONTEXT.set(PermissionContext(**defaults))
def _reset():
TOOL_PERMISSION_CONTEXT.reset(token)
return adapter, am, rail, rail_state, _reset
def test_unified_memory_visibility_no_context_is_noop() -> None:
"""无权限上下文(普通请求)时不做任何调整,与父方法守卫一致。"""
from jiuwenswarm.agents.harness.common.rails.permissions.owner_scopes import (
TOOL_PERMISSION_CONTEXT,
)
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
adapter._instance = SimpleNamespace(ability_manager=SimpleNamespace(remove=lambda n: None))
adapter._memory_rail = SimpleNamespace(
set_read_only=lambda v: (_ for _ in ()).throw(AssertionError("should not touch rail")),
restore_memory_tool=lambda a: (_ for _ in ()).throw(AssertionError("should not touch rail")),
)
token = TOOL_PERMISSION_CONTEXT.set(None)
try:
adapter._sync_unified_memory_tool_visibility()
finally:
TOOL_PERMISSION_CONTEXT.reset(token)
def test_unified_memory_visibility_group_avatar_read_only() -> None:
"""群聊数字分身:stock 五件套被清扫,统一卡只读不摘除。"""
adapter, am, rail, rail_state, reset = _visibility_env(
group_digital_avatar=True, avatar_mode=True
)
try:
adapter._sync_unified_memory_tool_visibility()
finally:
reset()
assert "memory" not in am.removed
assert rail_state == [True]
def test_unified_memory_visibility_disabled_removes_card() -> None:
"""记忆全禁(分身+禁用):统一卡被摘除并置只读。"""
adapter, am, rail, rail_state, reset = _visibility_env(
enable_memory=False, group_digital_avatar=True, avatar_mode=True
)
try:
adapter._sync_unified_memory_tool_visibility()
finally:
reset()
assert "memory" in am.removed
assert rail_state == [True]
def test_unified_memory_visibility_restore_branch() -> None:
"""非分身上下文:清扫五件套后恢复统一卡并解除只读。"""
adapter, am, rail, rail_state, reset = _visibility_env(avatar_mode=True)
try:
adapter._sync_unified_memory_tool_visibility()
finally:
reset()
assert am.removed == [
"write_memory",
"edit_memory",
"read_memory",
"memory_search",
"memory_get",
]
assert rail_state == ["restore", False]
def test_slim_search_skill_card_id_distinct_from_stock() -> None:
"""slim search_skill 卡 id 必须与 stock 版区分。
共享注册表按 card.id 先到先得,agent 模式 prewarm 先注册 stock 版
"search_skill";若 slim 版同 id,后注册为 no-op,flash 会话调到的
将是不带 install 参数的 stock 实例。name 保持不变(模型可见面不变)。
"""
from jiuwenswarm.agents.harness.flash.tools.slim_skill_toolkit import (
SlimSkillToolkit,
)
toolkit = SlimSkillToolkit(manager=None, service_id="svc", agent_id="ag")
tools = toolkit.get_tools()
assert [t.card.name for t in tools] == ["search_skill"]
assert tools[0].card.id != "search_skill"
# ── 统一 todo 工具(get action) ─────────────────────────────────────
def test_unified_todo_card_exposes_get_action() -> None:
tool = UnifiedTodoTool({}, language="cn")
assert "get" in tool.card.input_params["properties"]["action"]["enum"]
assert "id" in tool.card.input_params["properties"]
@pytest.mark.asyncio
async def test_unified_todo_get_forwards_id() -> None:
engine = _StubTodoEngine()
tool = UnifiedTodoTool({"get": engine}, language="cn")
result = await tool.invoke({"action": "get", "id": "t1"}, session="s1")
assert result == {"ok": True}
assert engine.calls == [({"id": "t1"}, {"session": "s1"})]
@pytest.mark.asyncio
async def test_unified_todo_get_requires_id() -> None:
"""参数错误返回结构化 ToolOutput(不 raise,与 FlashMemoryTool 同风格)。"""
tool = UnifiedTodoTool({"get": _StubTodoEngine()}, language="cn")
result = await tool.invoke({"action": "get"})
assert result.success is False
assert "'id' is required" in result.error
@pytest.mark.asyncio
async def test_unified_todo_unsupported_action_returns_error() -> None:
tool = UnifiedTodoTool({}, language="cn")
result = await tool.invoke({"action": "purge"})
assert result.success is False
assert "unsupported todo action" in result.error
# ── flash memory rail(只读双源 / 恢复注册) ─────────────────────────
def _make_memory_rail() -> FlashMemoryRail:
return FlashMemoryRail(
embedding_config=EmbeddingConfig(
model_name="m", base_url="http://embed", api_key="k"
),
is_proactive=False,
)
def test_flash_memory_rail_read_only_or() -> None:
"""读保护 = cron/heartbeat 只读 OR 群聊分身只读。"""
rail = _make_memory_rail()
assert rail._read_only_now() is False
rail._is_read_only = True
assert rail._read_only_now() is True
rail._is_read_only = False
rail.set_read_only(True)
assert rail._read_only_now() is True
rail.set_read_only(False)
assert rail._read_only_now() is False
def test_flash_memory_rail_restore_memory_tool() -> None:
"""场景2 按名移除后恢复分支重新注册;未被移除时不重复注册。"""
rail = _make_memory_rail()
tool = FlashMemoryTool(None, language="cn")
rail._unified_tool = tool
agent = SimpleNamespace(ability_manager=_FakeAbilityManager())
agent.ability_manager.tools["memory"] = tool.card
rail.restore_memory_tool(agent)
assert agent.ability_manager.adds == []
del agent.ability_manager.tools["memory"]
rail.restore_memory_tool(agent)
assert agent.ability_manager.adds == ["memory"]
def test_flash_memory_rail_restore_without_tool_is_noop() -> None:
rail = _make_memory_rail()
agent = SimpleNamespace(ability_manager=_FakeAbilityManager())
rail.restore_memory_tool(agent)
assert agent.ability_manager.adds == []
# ── flash 记忆档归一 ─────────────────────────────────────────────────
def test_flash_mode_memory_reads_agent_profile() -> None:
config = {"modes": {"agent": {"memory": {"enabled": True}}}}
assert is_agent_mode("flash") is True
assert is_memory_enabled("flash", config) is True
assert is_proactive_memory("flash", config) is False
# agent 档与未识别 mode 行为不变
assert is_memory_enabled("agent", config) is True
assert is_memory_enabled("team", config) is False
def test_flash_read_text_dependency_on_parent_signature() -> None:
"""flash read 依赖 ReadFileTool._read_text 的 apply_size_cap 关键字。
agent-core 升级若改掉该参数名/顺序,这里第一时间红,而不是在运行中
静默传错参数(read→edit 同文件回归见 flash_read_tool 注释)。
"""
import inspect
from openjiuwen.harness.tools.filesystem import ReadFileTool
params = inspect.signature(ReadFileTool._read_text).parameters
assert "apply_size_cap" in params
assert params["apply_size_cap"].kind is inspect.Parameter.POSITIONAL_OR_KEYWORD
@pytest.mark.asyncio
async def test_flash_read_multi_all_failed_sets_error() -> None:
"""多文件读取全部失败时 success=False 且 error 非空(ToolOutput 约定)。"""
from jiuwenswarm.agents.harness.flash.tools.flash_read_tool import (
FlashReadFileTool,
)
tool = object.__new__(FlashReadFileTool)
async def _fail(raw_path, model_name):
return {
"file_path": raw_path,
"content": "",
"type": "error",
"multimodal": [],
"line_count": 0,
"error": "boom",
}
tool._read_one_file = _fail
out = await tool._invoke_multi(["a.txt", "b.txt"], "m")
assert out.success is False
assert out.error and "failed" in out.error
assert out.data["succeeded"] == 0
assert out.data["failed"] == 2
def test_flash_memory_read_only_check_fails_closed() -> None:
"""只读探测回调抛异常时默认只读(fail-closed),不静默放开写入。"""
from jiuwenswarm.agents.harness.flash.tools.flash_memory_tool import (
FlashMemoryTool,
)
def _boom():
raise RuntimeError("heartbeat check exploded")
tool = object.__new__(FlashMemoryTool)
tool._read_only_flag = _boom
assert tool._is_read_only() is True
def test_flash_eager_tools_override_logs_dropped_deployment_entries() -> None:
"""flash eager_tools 整表替换时,被替换掉的部署名单差异必须打出日志。"""
adapter = _bare_adapter(JiuwenSwarmFlashAdapter)
config_base = {
"react": {
"tool_lazy_load": {
"eager_tools": ["visual_question_answering", "audio_metadata", "todo"]
}
}
}
# 同 test_evolution_env_bypass_warns:仓库 logger 不传播,直接挂模块 logger。
captured: list[str] = []
class _CaptureHandler(logging.Handler):
def emit(self, record: logging.LogRecord) -> None:
captured.append(record.getMessage())
handler = _CaptureHandler()
interface_flash.logger.addHandler(handler)
try:
merged = adapter._apply_flash_react_override(config_base)
finally:
interface_flash.logger.removeHandler(handler)
merged_eager = merged["react"]["tool_lazy_load"]["eager_tools"]
assert "todo" in merged_eager
assert "visual_question_answering" not in merged_eager
warning_text = " ".join(m for m in captured if "eager_tools" in m)
assert "visual_question_answering" in warning_text
assert "audio_metadata" in warning_text