Skip to content

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
6.5 KB
Raw Blame
# Copyright (c) Huawei Technologies Co., Ltd. 2026. All rights reserved.

"""Persistent subagent runtime wiring (shipped template on; missing key off)."""

from __future__ import annotations

from pathlib import Path
from types import SimpleNamespace

import pytest
import yaml

from jiuwenswarm.agents.harness.common.rails.browser_task_prompt_rail import (
    BrowserTaskPromptRail,
)
from jiuwenswarm.common.config import is_subagent_runtime_enabled
from jiuwenswarm.server.runtime.agent_adapter.interface_deep import (
    JiuWenSwarmDeepAdapter,
    _agent_ras_kwargs_from_config,
    _optional_enable_subagent_runtime,
)
from jiuwenswarm.server.runtime.agent_adapter.deep.pure_helpers import _session_has_live_subagent_runtime


def test_shipped_template_subagent_runtime_enabled_by_default() -> None:
    config_path = (
        Path(__file__).resolve().parents[3]
        / "jiuwenswarm"
        / "resources"
        / "config.yaml"
    )
    config = yaml.safe_load(config_path.read_text(encoding="utf-8"))
    assert config["react"]["subagent_runtime"]["enabled"] is True
    assert is_subagent_runtime_enabled(config) is True


def test_is_subagent_runtime_enabled_defaults_off() -> None:
    assert is_subagent_runtime_enabled({}) is False
    assert is_subagent_runtime_enabled({"react": {}}) is False
    assert is_subagent_runtime_enabled({"react": {"subagent_runtime": {}}}) is False
    assert is_subagent_runtime_enabled(
        {"react": {"subagent_runtime": {"enabled": False}}}
    ) is False
    assert is_subagent_runtime_enabled(
        {"react": {"subagent_runtime": {"enabled": True}}}
    ) is True


def test_resolve_enable_subagent_runtime_defaults_off() -> None:
    adapter = JiuWenSwarmDeepAdapter()
    assert adapter._resolve_enable_subagent_runtime({}) is False
    assert adapter._resolve_enable_subagent_runtime(
        {"react": {"subagent_runtime": {"enabled": True}}}
    ) is True


def test_build_subagent_rail_uses_browser_policy_and_stays_off() -> None:
    adapter = JiuWenSwarmDeepAdapter()
    rail = adapter._build_subagent_rail({})
    assert isinstance(rail, BrowserTaskPromptRail)
    assert rail.enable_subagent_runtime is False


def test_session_has_live_subagent_runtime_reads_capacity() -> None:
    live = SimpleNamespace(
        _instance=SimpleNamespace(
            _subagent_controls={
                "sess-1": SimpleNamespace(capacity=lambda: {"used": 2}),
            }
        )
    )
    idle = SimpleNamespace(
        _instance=SimpleNamespace(
            _subagent_controls={
                "sess-1": SimpleNamespace(capacity=lambda: {"used": 0}),
            }
        )
    )
    assert _session_has_live_subagent_runtime(
        live, "sess-1"
    ) is True
    assert _session_has_live_subagent_runtime(
        idle, "sess-1"
    ) is False
    assert _session_has_live_subagent_runtime(
        SimpleNamespace(_instance=None), "sess-1"
    ) is False


def test_session_has_live_subagent_runtime_fail_closed_when_capacity_raises() -> None:
    def _boom() -> dict[str, int]:
        raise RuntimeError("capacity unavailable")

    occupied = SimpleNamespace(
        _instance=SimpleNamespace(
            _subagent_controls={
                "sess-1": SimpleNamespace(capacity=_boom),
            }
        )
    )
    assert _session_has_live_subagent_runtime(
        occupied, "sess-1"
    ) is True


def test_session_has_live_subagent_runtime_missing_controls_is_idle() -> None:
    """dest-stable SDK and never-spawned parents have no control map."""
    missing = SimpleNamespace(_instance=SimpleNamespace())
    invalid = SimpleNamespace(_instance=SimpleNamespace(_subagent_controls="bad"))
    assert _session_has_live_subagent_runtime(
        missing, "sess-1"
    ) is False
    assert _session_has_live_subagent_runtime(
        invalid, "sess-1"
    ) is False


def test_release_subagent_runtime_clears_progress_batch() -> None:
    from jiuwenswarm.server.runtime.agent_adapter.subagent_stream import (
        clear_all_subagent_progress_batches,
        resolve_subagent_parallel_fields,
    )

    clear_all_subagent_progress_batches()
    resolve_subagent_parallel_fields(
        parent_session_id="sess-1",
        subagent_id="sa-a",
        legacy_status="starting",
    )
    adapter = JiuWenSwarmDeepAdapter()
    adapter._instance = None
    adapter._is_session_scoped_adapter = True
    adapter._parent_session_id = "sess-1"

    import asyncio

    asyncio.run(adapter.release_subagent_runtime_for_session("sess-1"))
    again = resolve_subagent_parallel_fields(
        parent_session_id="sess-1",
        subagent_id="sa-b",
        legacy_status="starting",
    )
    assert again == (0, 1, False)


def test_agent_ras_passthrough_still_enabled() -> None:
    kwargs = _agent_ras_kwargs_from_config({"agent_ras": {"enabled": True}})
    assert "agent_ras" in kwargs
    assert kwargs["agent_ras"] is not False


def test_code_mode_create_instance_passes_agent_ras_kwargs() -> None:
    """code 模式独立调用 create_deep_agent,agent_ras 须与 deep/flash 路径对齐透传."""
    import inspect

    from jiuwenswarm.server.runtime.agent_adapter.interface_code import (
        JiuwenSwarmCodeAdapter,
    )

    source = inspect.getsource(JiuwenSwarmCodeAdapter.create_instance)
    assert "**_agent_ras_kwargs_from_config(config_base)" in source


def test_optional_enable_subagent_runtime_follows_deep_agent_config_signature() -> None:
    """Official pin omits the field; overlay / post-3A SDK keeps it."""
    from inspect import signature

    from openjiuwen.harness.schema.config import DeepAgentConfig

    got = _optional_enable_subagent_runtime(True)
    params = signature(DeepAgentConfig.__init__).parameters
    if "enable_subagent_runtime" in params:
        assert got == {"enable_subagent_runtime": True}
    else:
        assert got == {}


def test_optional_enable_subagent_runtime_omits_flag_on_legacy_config(
    monkeypatch: pytest.MonkeyPatch,
) -> None:
    from dataclasses import dataclass

    from jiuwenswarm.server.runtime.agent_adapter import interface_deep as deep_mod
    from jiuwenswarm.server.runtime.agent_adapter.deep import agent_config_helpers as cfg_mod

    @dataclass
    class _LegacyDeepAgentConfig:
        enable_task_loop: bool = False

    # 定义在 agent_config_helpers;facade re-export 不会改函数体内名字查找。
    monkeypatch.setattr(cfg_mod, "DeepAgentConfig", _LegacyDeepAgentConfig)
    monkeypatch.setattr(deep_mod, "DeepAgentConfig", _LegacyDeepAgentConfig)
    assert deep_mod._optional_enable_subagent_runtime(True) == {}