Python Unit Test Overview

Rebased this branch onto current upstream/main.

Validation:

python -m pytest python\packages\core\tests\core\test_tools.py -q --basetemp .tmp\pytest-5773
python -m py_compile python\packages\core\agent_framework\_tools.py python\packages\core\tests\core\test_tools.py
git diff --check

@he-yufeng please check the failing tests

Rebased this branch onto current upstream/main after the failing-test ping.

Validation on the rebased head:

uv run --dev python -m pytest packages\core\tests\core\test_tools.py::test_invoke_sync_tool_does_not_block_event_loop packages\core\tests\core\test_tools.py::test_invoke_skip_parsing_awaits_async_functions -q --basetemp .tmp\pytest-5773-target
uv run --dev python -m pytest packages\core\tests\core\test_tools.py -q --basetemp .tmp\pytest-5773-full2
uv run --dev python -m ruff check packages\core\agent_framework\_tools.py packages\core\tests\core\test_tools.py
uv run --dev python -m py_compile packages\core\agent_framework\_tools.py packages\core\tests\core\test_tools.py
git diff --check upstream/main..HEAD

@he-yufeng Unit tests are still failing. Please have another look, thanks!

Thanks for the heads-up. The failing Python tests were coming from the background-agent tools: background_agents_start_task and background_agents_continue_task call asyncio.create_task(...), so running them through the new sync-tool thread offload left them without a running event loop.

I updated the branch so normal sync tools still run off the event loop by default, while these two event-loop-dependent harness tools opt into running on the current loop. I also rebased the branch onto current upstream/main.

Validated locally:

uv run --dev python -m ruff check packages/core/agent_framework/_tools.py packages/core/agent_framework/_harness/_background_agents.py packages/core/tests/core/test_tools.py packages/core/tests/core/test_harness_background_agents.py
uv run --dev python -m py_compile packages/core/agent_framework/_tools.py packages/core/agent_framework/_harness/_background_agents.py packages/core/tests/core/test_tools.py packages/core/tests/core/test_harness_background_agents.py
uv run --dev python -m mypy --config-file pyproject.toml packages/core/agent_framework/_tools.py packages/core/agent_framework/_harness/_background_agents.py
uv run --dev python -m pytest packages\core\tests\core\test_tools.py packages\core\tests\core\test_harness_background_agents.py -q --basetemp .tmp\pytest-5773-after-rebase

Rebased this branch onto current upstream/main again and reran the focused checks after the failing-test pings.

Validation on Windows:

uv run --dev python -m pytest packages\core\tests\core\test_tools.py packages\core\tests\core\test_harness_background_agents.py -q --basetemp .tmp\pytest-5773-20260604
uv run --dev python -m ruff check packages\core\agent_framework\_tools.py packages\core\agent_framework\_harness\_background_agents.py packages\core\tests\core\test_tools.py packages\core\tests\core\test_harness_background_agents.py
uv run --dev python -m py_compile packages\core\agent_framework\_tools.py packages\core\agent_framework\_harness\_background_agents.py packages\core\tests\core\test_tools.py packages\core\tests\core\test_harness_background_agents.py
uv run --dev python -m mypy --config-file pyproject.toml packages\core\agent_framework\_tools.py packages\core\agent_framework\_harness\_background_agents.py
git diff --check upstream/main..HEAD

The targeted test_tools.py and test_harness_background_agents.py set passes on the rebased head.

@he-yufeng

FAILED: pyright in packages/core
Poe => pyright
/home/runner/work/agent-framework/agent-framework/python/packages/core/agent_fra
mework/_harness/_background_agents.py
/home/runner/work/agent-framework/agent-framework/python/packages/core/agent_f
ramework/_harness/_background_agents.py:352:38 - error:
"_invoke_sync_on_event_loop" is protected and used outside of the class in which
it is declared (reportPrivateUsage)
/home/runner/work/agent-framework/agent-framework/python/packages/core/agent_f
ramework/_harness/_background_agents.py:476:41 - error:
"_invoke_sync_on_event_loop" is protected and used outside of the class in which
it is declared (reportPrivateUsage)
2 errors, 0 warnings, 0 informations

Pushed a small follow-up for the package-check failure.

Root cause: package-wide pyright reports the dynamic _invoke_sync_on_event_loop marker as private usage. The marker is intentional for these two harness tools, so this now uses a local pyright suppression at the assignment site instead of changing the runtime behavior.

Validation run locally:

• uv run --dev pyright packages\core\agent_framework\_harness\_background_agents.py: 0 errors
• uv run --dev ruff check packages\core\agent_framework\_harness\_background_agents.py: passed
• uv run --dev ruff format --check packages\core\agent_framework\_harness\_background_agents.py: passed
• uv run --dev mypy packages\core\agent_framework\_harness\_background_agents.py: passed
• uv run --dev python -m pytest packages\core\tests\core\test_tools.py packages\core\tests\core\test_harness_background_agents.py -q --basetemp .tmp\pytest-5773-20260604c: passed
• git diff --check: passed

The Windows full-test jobs also reported a _native_wasm::WasmSandbox unraisable cleanup error near the end of the complete suite; that appears outside this PR's touched harness-tool path, so I left the code change scoped to the pyright package-check failure.