Fix messaging task launch on uvloop (#1117)

## Problem

uvloop 0.22.1 rejects the Python 3.14-only `eager_start` task keyword,
so every Telegram and Discord message fails on Unix. Removing the
keyword alone would let eager task factories execute claims before FCC
publishes task ownership. Fixes #1108 and fixes #1115.

## Changes

| Before | After |
| --- | --- |
| Claim tasks depend on `eager_start=False`, which uvloop does not
accept. | Claim tasks use the portable event-loop contract behind an
explicit ownership gate. |
| Task execution ordering depends on event-loop keyword support. | Task
execution begins only after FCC attaches the task and completion
callback. |
| Regression coverage exercises native asyncio only. | Regression
coverage exercises a restricted task contract, eager task factories, and
real uvloop. |
| The package version is 4.5.0. | The package version is 4.5.1 with a
refreshed lockfile. |

<!-- greptile_comment -->

<details open><summary><h3>Greptile Summary</h3></summary>

This PR fixes messaging claim launch on event loops that reject
Python-specific task keywords. The main changes are:

- Removes `eager_start=False` from claim task creation.
- Adds an explicit ownership gate before claim processing starts.
- Adds tests for portable task creation, eager task factories, and
uvloop.
- Bumps the package version and lockfile entry to `4.5.1`.
</details>

<h3>Confidence Score: 5/5</h3>

This looks safe to merge after a small test hardening cleanup.

The runtime task ownership change preserves the intended launch
ordering, and no blocking issues were found in the changed runtime code.

tests/messaging/test_tree_ownership_concurrency.py needs a small
hardening update so the uvloop case skips cleanly when the optional
package is absent.

<details><summary><h3><a href="https://www.greptile.com/trex"><img
alt="T-Rex"
src="https://greptile-static-assets.s3.amazonaws.com/trex/trex_green.svg"
height="20" align="absmiddle"></a> T-Rex Logs</h3></summary>

**What T-Rex did**
- T-Rex executed the messaging ownership regression pytest suite to
capture runtime proof for the messaging concurrency changes.
- During the run, the first shell wrapper used PIPESTATUS\[0\] under
/bin/sh, producing a harmless Bad substitution during version evidence
collection.
- The pytest command was rerun after the substitution issue, and the run
completed with EXIT\_CODE: 0.
- The regression suite provides focused runtime evidence for the
messaging concurrency behavior, avoiding unrelated suites or external
services.

<a
href="https://app.greptile.com/trex/runs/14465005/artifacts"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://greptile-static-assets.s3.amazonaws.com/badges/ViewAllArtifactsDark.svg?v=4"><source
media="(prefers-color-scheme: light)"
srcset="https://greptile-static-assets.s3.amazonaws.com/badges/ViewAllArtifacts.svg?v=4"><img
alt="View all artifacts"
src="https://greptile-static-assets.s3.amazonaws.com/badges/ViewAllArtifacts.svg?v=4"></picture></a>

_{<a href="https://www.greptile.com/trex"><img alt="T-Rex"
src="https://greptile-static-assets.s3.amazonaws.com/trex/trex_green.svg"
height="14" align="absmiddle"></a> Ran code and verified through
T-Rex}
</details>

<details open><summary><h3>Important Files Changed</h3></summary>

| Filename | Overview |
|----------|----------|
| src/free_claude_code/messaging/trees/processor.py | Replaces the
uvloop-incompatible task keyword with an ownership event that opens
after task registration. |
| tests/messaging/test_tree_ownership_concurrency.py | Adds task-launch
tests, with one uvloop test that can fail instead of skip when uvloop is
absent. |
| pyproject.toml | Bumps the package version to `4.5.1`. |
| uv.lock | Updates the editable package version to match
`pyproject.toml`. |

</details>

<a
href="https://app.greptile.com/api/ide/codex?prompt=IMPORTANT%3A%20Work%20in%20the%20repository%20%22alishahryar1%2Ffree-claude-code%22%20on%20the%20existing%20branch%20%22ali%2Ffix-messaging-event-loop-compatibility%22.%20Checkout%20that%20branch%20%E2%80%94%20do%20NOT%20create%20a%20new%20branch%20or%20open%20a%20new%20PR.%20Push%20your%20changes%20to%20%22ali%2Ffix-messaging-event-loop-compatibility%22.%0A%0AFix%20the%20following%201%20code%20review%20issue.%20Work%20through%20them%20one%20at%20a%20time%2C%20proposing%20concise%20fixes.%0A%0A---%0A%0A%23%23%23%20Issue%201%20of%201%0Atests%2Fmessaging%2Ftest_tree_ownership_concurrency.py%3A485%0A**Optional%20Uvloop%20Becomes%20Required**%0A%0AWhen%20tests%20run%20on%20Linux%20or%20macOS%20without%20the%20optional%20%60uvloop%60%20package%20installed%2C%20this%20import%20raises%20%60ModuleNotFoundError%60%20instead%20of%20skipping%20the%20uvloop-only%20case.%20A%20contributor%20or%20CI%20job%20that%20installs%20only%20the%20test%20dependencies%20can%20fail%20this%20test%20even%20though%20the%20platform%20skip%20condition%20passes.%0A%0A&repo=alishahryar1%2Ffree-claude-code&pr=1117&platform=github"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://greptile-static-assets.s3.amazonaws.com/badges/FixAllInCodexDark.svg?v=6"><source
media="(prefers-color-scheme: light)"
srcset="https://greptile-static-assets.s3.amazonaws.com/badges/FixAllInCodex.svg?v=6"><img
alt="Fix All in Codex"
src="https://greptile-static-assets.s3.amazonaws.com/badges/FixAllInCodex.svg?v=6"></picture></a>

_{Reviews (1): Last reviewed commit: ["Fix messaging task launch on
uvloop"](https://github.com/alishahryar1/free-claude-code/commit/180a7255df0a43a20706cdde2f1cd2d6830921d7)
| [Re-trigger
Greptile](https://app.greptile.com/api/retrigger?id=44296382)}

> Greptile also left **1 inline comment** on this PR.

<!-- /greptile_comment -->

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"

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:

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)
 
 
+@pytest.mark.asyncio
+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()
+
+
+@pytest.mark.skipif(
+    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()

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" },