Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

Fix messaging task launch on uvloop (#1117)

Ali Khokharabaee5bd38db
diff --git a/pyproject.toml b/pyproject.toml
index ea16180e..3c3d5508 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "free-claude-code"
-version = "4.5.0"
+version = "4.5.1"
description = "Local proxy connecting coding agents to OpenAI-compatible AI providers"
readme = "README.md"
requires-python = ">=3.14.0"
diff --git a/src/free_claude_code/messaging/trees/processor.py b/src/free_claude_code/messaging/trees/processor.py
index d13eec22..11039ada 100644
--- a/src/free_claude_code/messaging/trees/processor.py
+++ b/src/free_claude_code/messaging/trees/processor.py
@@ -81,8 +81,10 @@ class TreeQueueProcessor:
slot = _TaskSlot(tree=tree, claim=claim)
self._tasks[key] = slot
self._idle.clear()
+ ownership_ready = asyncio.Event()
claim_runner = self._run_claim(
slot,
+ ownership_ready=ownership_ready,
announce_started=announce_started,
queue=queue,
)
@@ -90,7 +92,6 @@ class TreeQueueProcessor:
task = asyncio.create_task(
claim_runner,
name=(f"messaging-claim-{claim.identity.root_id}-{claim.claim_id[:8]}"),
- eager_start=False,
)
except BaseException:
claim_runner.close()
@@ -101,6 +102,7 @@ class TreeQueueProcessor:
raise
slot.task = task
task.add_done_callback(lambda _task, claim_key=key: self._task_done(claim_key))
+ ownership_ready.set()
def _task_done(self, key: str) -> None:
"""Recover a claim if its task was cancelled before entering its body."""
@@ -156,9 +158,11 @@ class TreeQueueProcessor:
self,
slot: _TaskSlot,
*,
+ ownership_ready: asyncio.Event,
announce_started: bool,
queue: tuple[QueueEntry, ...],
) -> None:
+ await ownership_ready.wait()
claim = slot.claim
try:
if announce_started:
diff --git a/tests/messaging/test_tree_ownership_concurrency.py b/tests/messaging/test_tree_ownership_concurrency.py
index e324c9a8..3b116eda 100644
--- a/tests/messaging/test_tree_ownership_concurrency.py
+++ b/tests/messaging/test_tree_ownership_concurrency.py
@@ -1,5 +1,6 @@
import asyncio
import contextlib
+import sys
import pytest
@@ -450,6 +451,54 @@ async def test_eager_task_factory_cannot_run_claim_before_admission_returns() ->
await _wait_for_no_tasks(manager)
+async def test_claim_launch_uses_portable_event_loop_task_contract(
+ monkeypatch: pytest.MonkeyPatch,
+) -> None:
+ processed = asyncio.Event()
+
+ async def process(_claim: NodeClaim) -> None:
+ processed.set()
+
+ loop = asyncio.get_running_loop()
+ original_create_task = loop.create_task
+
+ def portable_create_task(coro, *, name=None, context=None):
+ return original_create_task(coro, name=name, context=context)
+
+ monkeypatch.setattr(loop, "create_task", portable_create_task)
+ manager = TreeQueueManager(process)
+
+ decision = await manager.admit(_incoming("root"), "status-root")
+ await asyncio.wait_for(manager.wait_idle(), timeout=1)
+
+ assert decision.accepted is True
+ assert processed.is_set()
+
+
+ sys.platform in {"cygwin", "win32"} or sys.implementation.name == "pypy",
+ reason="uvloop is not installed on this Python platform",
+)
+def test_claim_launch_runs_on_uvloop() -> None:
+ uvloop = pytest.importorskip("uvloop")
+
+ async def scenario() -> None:
+ processed = asyncio.Event()
+
+ async def process(_claim: NodeClaim) -> None:
+ processed.set()
+
+ manager = TreeQueueManager(process)
+ decision = await manager.admit(_incoming("root"), "status-root")
+ await asyncio.wait_for(manager.wait_idle(), timeout=1)
+
+ assert decision.accepted is True
+ assert processed.is_set()
+
+ uvloop.run(scenario())
+
+
@pytest.mark.asyncio
async def test_absorbed_pre_run_cancellation_cannot_start_node_processor() -> None:
root_started = asyncio.Event()
diff --git a/uv.lock b/uv.lock
index 6976b4da..4b6a4672 100644
--- a/uv.lock
+++ b/uv.lock
@@ -561,7 +561,7 @@ wheels = [
[[package]]
name = "free-claude-code"
-version = "4.5.0"
+version = "4.5.1"
source = { editable = "." }
dependencies = [
{ name = "aiohttp" },