Render embedding observability (0059b)

[chris-colinsky]

Summary

Renders the embedding observability for proposal 0059 (the "0059b" half),
completing the embedding capability merged in #196. The provider already
dispatched the typed EmbeddingEvent / EmbeddingFailedEvent; both bundled
observers now render them, the conformance harness drives them, and fixtures
074-083 + 137 pass.

Changes

• Event: EmbeddingEvent gains output_vectors (proposal 0089), populated
  on the success event from the response vectors; the failure event carries no
  output.
• OTel: an openarmature.embedding.complete span parented lineage-aware
  under the calling node, carrying the disable_genai_semconv-gated GenAI
  subset, the openarmature.embedding.input_count / .dimensions identity
  attrs, and the disable_provider_payload-gated .input.strings /
  .request.extras; the failure path renders ERROR + error.type + an
  exception event. The attribute_enrichers union is widened to the embedding
  events.
• Langfuse: a dedicated Embedding observation (asType="embedding") with
  model, usageDetails, the openarmature_* metadata, and the payload-gated
  input strings + output vectors; the failure path renders an ERROR-level
  observation.
• Harness: a graph-node embedding runner so the events flow through the
  observer queue; un-defers 074-083 + 137; extends the Langfuse
  observation-tree assertion for model + usageDetails.
• conformance.toml: 0059 to implemented. Fixture 089 (embedding metrics)
  stays deferred under 0067 (the GenAI metric instruments are not yet wired to
  the embedding event).

Tests

• Fixtures 074-083 + 137 pass (089 metrics deferred).
• Full conformance + unit + smoke: 1487 passed. ruff + pyright clean.

Follow-ups

• Implement proposal 0010: bounded drain timeout #69: wire the GenAI metric instruments to EmbeddingEvent (un-defers 089).

[Copilot]

Pull request overview

Implements the “0059b” half of embedding observability: embedding provider calls now produce first-class observability output in both bundled observers (OTel + Langfuse), and the conformance harness runs the embedding observability fixtures end-to-end.

Changes:

• Extend EmbeddingEvent with output_vectors and populate it from EmbeddingResponse.vectors on success.
• Render embedding calls in observability backends: OTel emits openarmature.embedding.complete spans; Langfuse emits a dedicated asType="embedding" observation (including payload gating behavior).
• Update conformance harness/fixture plumbing to run embedding observability fixtures (074–083, 137) while keeping embedding-metrics (089) deferred under 0067.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tests/unit/test_retrieval_provider.py	Updates unit tests to reflect embedding events now render, and verifies observer no-op behavior outside invocation context.
tests/conformance/test_observability.py	Adds embedding fixture execution path and extends Langfuse observation-tree assertions (model / usageDetails / statusMessage).
tests/conformance/test_fixture_parsing.py	Adjusts fixture-parsing deferrals now that embedding observability fixtures run in test_observability.
src/openarmature/retrieval/providers/openai.py	Populates EmbeddingEvent.output_vectors from the parsed embedding response vectors.
src/openarmature/observability/otel/observer.py	Adds typed embedding event handling and emits openarmature.embedding.complete spans with proper gating and error mapping.
src/openarmature/observability/langfuse/observer.py	Adds typed embedding event handling and emits dedicated Langfuse embedding observations with proper gating and error mapping.
src/openarmature/observability/langfuse/client.py	Extends the Langfuse Protocol + in-memory recorder to support an embedding observation type.
src/openarmature/observability/langfuse/adapter.py	Implements the adapter-side embedding() operation (including back-dated start time support).
src/openarmature/graph/events.py	Adds EmbeddingEvent.output_vectors field (proposal 0089) and documents its rendering contract.
conformance.toml	Marks proposal 0059 as implemented (since 0.16.0) and updates 0067 note to reflect remaining embedding-metrics gap.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.