Release v0.3.3

Focus

0.3.3 is a short additive release that makes the 0.3.x AI and
observability story easier to trust in real worker deployments.

This release is about tightening existing extension paths rather than opening a
new platform phase:

• the AI provider contract now matches real provider capabilities
• Anthropic is now part of the official plugin bundle
• config-driven workers can enable OpenTelemetry through the existing tracing path
• short-term release docs and packaging now match the shipped support story

---

Highlights

AI provider capabilities are now explicit

Agora now treats completion and embeddings as separate capabilities instead of
implying every provider must implement both.

AIProvider remains as the compatibility-facing completion contract for
existing middleware, while the codebase now exposes clearer capability helpers:

• CompletionProvider
• EmbeddingProvider
• require_completion_provider(...)
• require_embedding_provider(...)

This makes completion-only providers such as Anthropic first-class without
forcing fake embedding implementations, and it gives embedding-dependent paths a
clear failure mode when the wrong provider is supplied.

Anthropic is now part of the official first-party bundle

Anthropic support has been promoted into agora-etl-plugins through the new
anthropic extra.

The official import and install story is now:

• pip install "agora-etl-plugins[anthropic]"
• from agora_plugins.anthropic import AnthropicProvider

The supported scope stays intentionally narrow and honest:

• completion
• structured JSON output
• completion-driven AI middlewares

It still does not promise:

• embeddings
• embedding-based classification
• embedding stores

This keeps the public bundle story truthful while still making Anthropic an
official first-party integration.

Config-driven workers can now turn on OTel without custom bootstrap code

Worker startup can now be driven directly from agora/v1 config, including
top-level worker settings and per-pipeline schedules.

Tracing config also gained an auto_configure path for OpenTelemetry. When
enabled, Agora now:

• reuses an existing global tracer provider if one is already configured
• otherwise auto-configures an OTLP exporter when the optional OTel SDK and
  exporter packages are installed

This keeps observability on the existing tracing path instead of introducing a
second tracing system.

Docs and packaging now tell a cleaner release story

The 0.3.3 docs now align better with the real public support boundary:

• plugin docs position Anthropic as part of the official bundle
• worker and observability docs show the config-only OTel path
• changelog and release metadata now match the promoted plugin surface

---

Upgrade notes

For AI users

• completion-only providers are now valid without embedding methods
• embedding-based features still require an embedding-capable provider
• Anthropic should now be installed from agora-etl-plugins[anthropic]

For worker operators

• agora worker --config ... can now build a WorkerPool directly from TOML
• each config-driven worker pipeline must define [pipelines.<name>.schedule]
• OTel config can now stay declarative when the optional OTel packages are
  installed

For plugin users

• agora-etl-plugins now targets agora-etl>=0.3.3
• Anthropic is now part of the official bundle instead of a separate release
  story

---

Validation

Release validation for 0.3.3 includes:

• full package-local coverage for the Anthropic official bundle path
• worker/config/tracing regression coverage for OTel auto-wiring
• strict docs builds for the main Agora documentation site
• full monorepo CI for agora-etl and agora-etl-plugins