fix(worker): know you are in a worker from any thread, not only the task's

Celery records the executing task on the thread that runs it, so a thread that
task starts sees none. The embeddings client and read_document both decided
"am I in a worker?" from that alone, and from any other thread took the
web-process branch: dispatch to the worker they were running in and block on
the result. Celery refuses that get() ("Never call result.get() within a
task!"), so the embed failed and latched the 30s dispatch cooldown for every
caller after it; with joins allowed, read_document would instead wait on a
parsing queue only its own busy process serves.

Threads inside tasks are not hypothetical: per-source retrieval fans out to a
pool, so a scheduled or webhook agent searching several sources embedded from
pool threads. Graph extraction did too, which failed every chunk of a build.

in_worker() in celery_init answers for the whole process. Celery's
task_join_will_block is process-wide and set for every blocking pool (prefork,
solo, threads) -- exactly the condition under which dispatch-and-wait goes
wrong; eventlet/gevent leave it unset, so the task's own thread still counts
through current_worker_task. Verified with real workers on each blocking pool:
from a thread a task started, the old check dispatched and hit the error, the
new one embedded locally.
This commit is contained in:
Alex committed 2026-09-19 14:07:42 +01:00
1 parent 5e67f8c927
commit 15bdda8554
6 files changed
+117 -16

No files matched your search

+23
View File
@@ -172,6 +172,29 @@ def _run_version_check(*args, **kwargs):
celery = make_celery()
celery.config_from_object("docsgpt.celeryconfig")
def in_worker() -> bool:
"""True anywhere in a Celery worker process, on any thread.
``current_worker_task`` alone is not enough: Celery records the executing
task on the thread that runs it, so a thread the task starts sees none and
would take the web-process branch — dispatching to the worker it is running
in and blocking on the result. Celery refuses that ``get()`` ("Never call
result.get() within a task!"), or, where joins are allowed, it waits on a
queue only this busy process serves.
``task_join_will_block`` is process-wide and set for every blocking pool
(prefork, solo, threads) — exactly the condition under which dispatching
and waiting goes wrong. eventlet/gevent leave it unset, so the task's own
thread still counts through ``current_worker_task``.
Returns:
bool: Whether this call is running inside a worker process.
"""
from celery.result import task_join_will_block
return task_join_will_block() or celery.current_worker_task is not None
#: Task-name prefix the package carried before the rename to ``docsgpt``.