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
9.2 KB
Raw Blame
"""Evolution approval coordinator unit tests."""

from types import SimpleNamespace

from jiuwenswarm.gateway.message_handler.evolution_approval import (
    SKILL_EVOLUTION_APPROVAL_SCHEMA,
    SKILL_EVOLUTION_APPROVAL_SOURCE,
    EvolutionApprovalCoordinator,
    ensure_regular_evolution_approval_metadata,
    is_evolution_approval_payload,
    is_interrupt_evolution_approval_answer_payload,
)


_INTERRUPT_META = {
    "event_kind": "approval",
    "rail_kind": "regular",
    "approval_kind": "evolve",
    "approval_transport": "interrupt",
}


def _chunk(payload: dict[str, object]) -> SimpleNamespace:
    return SimpleNamespace(
        channel_id="web",
        request_id="stream-1",
        payload=payload,
    )


def _approval_chunk(request_id: str, **extra: object) -> SimpleNamespace:
    payload: dict[str, object] = {
        "event_type": "chat.ask_user_question",
        "request_id": request_id,
        "questions": [{"header": "x"}],
        **extra,
    }
    return _chunk(payload)


def test_approval_payload_recognizes_request_id_and_metadata() -> None:
    assert is_evolution_approval_payload({"request_id": "skill_evolve_1"}) is True
    assert is_evolution_approval_payload({"request_id": "team_skill_evolve_1"}) is True
    assert is_evolution_approval_payload({"request_id": "call_1"}) is False
    assert is_evolution_approval_payload({"source": SKILL_EVOLUTION_APPROVAL_SOURCE}) is True
    assert is_evolution_approval_payload({"approval_schema": SKILL_EVOLUTION_APPROVAL_SCHEMA}) is True
    assert is_evolution_approval_payload({"evolution_meta": {"event_kind": "approval"}}) is True
    assert is_evolution_approval_payload("not-a-payload") is False
    assert is_interrupt_evolution_approval_answer_payload({
        "request_id": "call_1",
        "source": SKILL_EVOLUTION_APPROVAL_SOURCE,
    }) is True


def test_regular_metadata_enrichment_preserves_existing_transport() -> None:
    enriched = ensure_regular_evolution_approval_metadata({
        "request_id": "call_123",
        "evolution_meta": {"approval_transport": "interrupt"},
    })

    assert enriched["source"] == SKILL_EVOLUTION_APPROVAL_SOURCE
    assert enriched["approval_schema"] == SKILL_EVOLUTION_APPROVAL_SCHEMA
    assert enriched["evolution_meta"] == _INTERRUPT_META
    assert is_interrupt_evolution_approval_answer_payload(enriched) is True


def test_evolution_status_start_and_end_tracks_in_progress() -> None:
    coordinator = EvolutionApprovalCoordinator()

    coordinator.handle_chunk(
        _chunk({"event_type": "chat.evolution_status", "status": "start"}),
        "sess-1",
        auto_save_enabled=True,
    )
    assert coordinator.is_session_in_progress("sess-1") is True

    coordinator.handle_chunk(
        _chunk({"event_type": "chat.evolution_status", "status": "end"}),
        "sess-1",
        auto_save_enabled=True,
    )
    assert coordinator.is_session_in_progress("sess-1") is False


def test_auto_save_false_incoming_approval_marks_pending() -> None:
    coordinator = EvolutionApprovalCoordinator()

    decision = coordinator.handle_chunk(
        _approval_chunk(
            "call_123",
            source=SKILL_EVOLUTION_APPROVAL_SOURCE,
            approval_schema=SKILL_EVOLUTION_APPROVAL_SCHEMA,
        ),
        "sess-1",
        auto_save_enabled=False,
    )

    assert decision.should_publish_chunk is True
    assert decision.user_message is None
    assert coordinator.pending_request_id("sess-1") == "call_123"


def test_auto_save_true_auto_accepts_first_approval_and_suppresses_chunk() -> None:
    coordinator = EvolutionApprovalCoordinator()

    decision = coordinator.handle_chunk(
        _approval_chunk("team_skill_evolve_new"),
        "sess-1",
        {"k": "v"},
        auto_save_enabled=True,
    )

    assert decision.should_publish_chunk is False
    assert coordinator.pending_request_id("sess-1") is None
    assert decision.user_message is not None
    auto_msg = decision.user_message
    assert auto_msg.session_id == "sess-1"
    assert auto_msg.channel_id == "web"
    assert auto_msg.metadata == {"k": "v"}
    assert auto_msg.params["request_id"] == "team_skill_evolve_new"
    assert auto_msg.params["answers"] == [{"selected_options": ["接收"]}]


def test_auto_save_true_auto_accepts_incoming_approval_with_existing_pending() -> None:
    coordinator = EvolutionApprovalCoordinator()
    coordinator.mark_pending("sess-1", "team_skill_evolve_old")

    decision = coordinator.handle_chunk(
        _approval_chunk("team_skill_evolve_new"),
        "sess-1",
        {"k": "v"},
        auto_save_enabled=True,
    )

    assert decision.should_publish_chunk is False
    assert coordinator.pending_request_id("sess-1") == "team_skill_evolve_old"
    assert decision.user_message is not None
    auto_msg = decision.user_message
    assert auto_msg.session_id == "sess-1"
    assert auto_msg.channel_id == "web"
    assert auto_msg.metadata == {"k": "v"}
    assert auto_msg.params["request_id"] == "team_skill_evolve_new"
    assert auto_msg.params["answers"] == [{"selected_options": ["接收"]}]


def test_auto_save_true_does_not_auto_accept_interrupt_approval() -> None:
    coordinator = EvolutionApprovalCoordinator()

    decision = coordinator.handle_chunk(
        _approval_chunk(
            "call_123",
            source=SKILL_EVOLUTION_APPROVAL_SOURCE,
            approval_schema=SKILL_EVOLUTION_APPROVAL_SCHEMA,
        ),
        "sess-1",
        {"k": "v"},
        auto_save_enabled=True,
    )

    assert decision.should_publish_chunk is True
    assert decision.user_message is None
    assert coordinator.pending_request_id("sess-1") == "call_123"


def test_hidden_regular_auto_save_finish_clears_without_current_pending() -> None:
    coordinator = EvolutionApprovalCoordinator()
    decision = coordinator.handle_chunk(
        _approval_chunk("team_skill_evolve_new"),
        "sess-1",
        auto_save_enabled=True,
    )

    assert decision.should_publish_chunk is False

    result = coordinator.finish_if_current("sess-1", "team_skill_evolve_new")

    assert result is not None
    assert result.queued_supplement is None
    assert result.promoted_approval is None
    assert coordinator.pending_request_id("sess-1") is None


def test_auto_save_false_defers_replaced_approval_and_suppresses_chunk() -> None:
    coordinator = EvolutionApprovalCoordinator()
    coordinator.mark_pending("sess-1", "team_skill_evolve_old")

    decision = coordinator.handle_chunk(
        _approval_chunk("team_skill_evolve_new"),
        "sess-1",
        auto_save_enabled=False,
    )

    assert decision.should_publish_chunk is False
    assert decision.user_message is None
    assert coordinator.pending_request_id("sess-1") == "team_skill_evolve_old"
    assert coordinator.deferred_request_ids("sess-1") == ["team_skill_evolve_new"]


def test_finish_current_clears_state_and_releases_queued_supplement() -> None:
    coordinator = EvolutionApprovalCoordinator()
    coordinator.mark_pending("sess-1", "call_123")
    coordinator.mark_session_in_progress("sess-1")
    coordinator.queue_supplement("sess-1", "继续补充", [{"path": "a.py"}])

    result = coordinator.finish_if_current("sess-1", "call_123")

    assert result is not None
    assert result.queued_supplement == {"new_input": "继续补充", "attachments": [{"path": "a.py"}]}
    assert result.promoted_approval is None
    assert coordinator.pending_request_id("sess-1") is None
    assert coordinator.is_session_in_progress("sess-1") is False
    assert coordinator.queued_supplement("sess-1") is None


def test_stale_finish_keeps_current_pending_and_queued_supplement() -> None:
    coordinator = EvolutionApprovalCoordinator()
    coordinator.mark_pending("sess-1", "call_new")
    coordinator.mark_session_in_progress("sess-1")
    coordinator.queue_supplement("sess-1", "继续补充")

    queued = coordinator.finish_if_current("sess-1", "call_old")

    assert queued is None
    assert coordinator.pending_request_id("sess-1") == "call_new"
    assert coordinator.is_session_in_progress("sess-1") is True
    assert coordinator.queued_supplement("sess-1") == {"new_input": "继续补充"}


def test_finish_current_promotes_deferred_approval() -> None:
    coordinator = EvolutionApprovalCoordinator()
    coordinator.mark_pending("sess-1", "team_skill_evolve_old")
    coordinator.handle_chunk(
        _approval_chunk("team_skill_evolve_new", questions=[{"header": "deferred"}]),
        "sess-1",
        {"k": "v"},
        auto_save_enabled=False,
    )
    coordinator.queue_supplement("sess-1", "继续补充")

    result = coordinator.finish_if_current("sess-1", "team_skill_evolve_old")

    assert result is not None
    assert result.queued_supplement is None
    assert result.promoted_approval is not None
    assert result.promoted_approval.request_id == "team_skill_evolve_new"
    assert result.promoted_approval.channel_id == "web"
    assert result.promoted_approval.payload["questions"] == [{"header": "deferred"}]
    assert result.promoted_approval.metadata == {"k": "v"}
    assert coordinator.pending_request_id("sess-1") == "team_skill_evolve_new"
    assert coordinator.is_session_in_progress("sess-1") is True
    assert coordinator.deferred_request_ids("sess-1") == []
    assert coordinator.queued_supplement("sess-1") == {"new_input": "继续补充"}