Aleix Conchillo Flaqué
b03247f360
Rename BaseTask → BaseWorker and reserve "task" for asyncio
...
Replaces every "task" identifier that referred to the BaseTask
abstraction with "worker". Asyncio task plumbing (asyncio.Task,
BaseTaskManager, TaskManager, create_task, cancel_task, etc.) stays
untouched. Highlights:
- Classes: BaseTask → BaseWorker, PipelineTask → PipelineWorker,
LLMTask → LLMWorker, LLMContextTask → LLMContextWorker, TaskBus →
WorkerBus, TaskRegistry → WorkerRegistry, TaskActivationArgs →
WorkerActivationArgs, TaskReadyData → WorkerReadyData,
TaskRegistryEntry → WorkerRegistryEntry, TaskObserver →
WorkerObserver, all Bus*TaskMessage → Bus*WorkerMessage,
BusAddTaskMessage.task field → worker, BusWorkerRegistryMessage.tasks
field → workers.
- Methods/decorators: activate_task → activate_worker, deactivate_task
→ deactivate_worker, add_task → add_worker, watch_task →
watch_worker, @task_ready → @worker_ready, setup_pipeline_task hook
→ setup_pipeline_worker.
- Params/fields: FrameProcessorSetup.pipeline_task and
FunctionCallParams.pipeline_task → pipeline_worker. Parameter names
like task_name → worker_name; spawn/run accept worker:.
- Files: pipeline/base_task.py → base_worker.py, pipeline/task.py →
worker.py (plus a re-export shim at pipeline/task.py),
task_observer.py → worker_observer.py, task_ready_decorator.py →
worker_ready_decorator.py, pipecat.tasks → pipecat.workers,
llm_task.py → llm_worker.py, llm_context_task.py →
llm_context_worker.py, examples/multi-task → examples/multi-worker.
Back-compat:
- PipelineTask kept as a deprecated subclass of PipelineWorker that
warns on construction.
- pipecat.pipeline.task re-exports PipelineWorker/PipelineTask/etc. so
existing user imports keep working.
- FrameProcessor.pipeline_task kept as a deprecated property that
forwards to pipeline_worker.
Local variables in examples that hold a worker (task = PipelineTask(...))
are renamed to worker = PipelineWorker(...). Asyncio-task locals
(runner_task, etc.) are preserved.
2026-05-21 19:07:13 -07:00
Mark Backman
58a17c7b1b
Include examples in type checking
...
Remove `examples/` from the `pyrightconfig.json` ignore list and fix
the resulting type errors across all example files. Common fixes:
- Required API keys: `os.getenv("X")` -> `os.environ["X"]` so the
return type is `str` rather than `str | None`, and misconfiguration
fails fast.
- Narrow `LLMContextMessage` union members with `isinstance(..., dict)`
before dict-style access.
- `assert isinstance(params.llm, ...)` before calling service-specific
methods that aren't on the base `LLMService`.
- Guard optional frame fields (e.g. `LLMSearchResponseFrame.search_result`)
before use.
2026-04-21 15:43:31 -04:00
Aleix Conchillo Flaqué
b3bb6fdaa5
Modernize Python typing across the codebase
...
Automated via ruff UP006, UP007, UP035, UP045 rules (target: py311):
- Replace `typing.List`, `Dict`, `Tuple`, `Set`, `FrozenSet`, `Type`
with their built-in equivalents (`list`, `dict`, `tuple`, etc.)
- Replace `typing.Optional[X]` with `X | None`
- Replace `typing.Union[X, Y]` with `X | Y`
- Move `Mapping`, `Sequence`, `Callable`, `Awaitable`,
`MutableMapping`, `MutableSequence`, `Iterator`, `AsyncIterator`,
`AsyncGenerator` imports from `typing` to `collections.abc`
- Remove now-unused `typing` imports
- Add `from __future__ import annotations` to 5 files that use
forward-reference strings in `X | "Y"` annotations
2026-04-16 09:28:23 -07:00
Mark Backman
1d85aedcae
Split features/ into audio/, observability/, and rag/ subfolders
...
Extract focused example groups from the catch-all features/ folder:
- audio/: audio recording, background sound, sound effects
- observability/: observer, heartbeats, sentry metrics
- rag/: mem0, gemini-rag, gemini grounding metadata
Update README to document the new folders.
2026-03-31 13:15:06 -04:00
