fix(instrumentation-py): repair OpenLIT, OpenRouter, and PGVector OTel 2.x spans

[Nightingalelyy]

Summary

• Repair OpenLIT, OpenRouter, and PGVector OTel 2.x instrumentation across current SDK shapes, lifecycle ownership, streaming, tools, errors, and bounded privacy-safe serialization.
• Add current real-SDK/export regressions and a patch release intent for all three packages.
• Preserve canonical span-contract fields without compatibility aliases.

Validation

• Focused package tests: OpenLIT 30/30, OpenRouter 49/49, PGVector 22/22 plus 2 credential-gated live-database skips.

• Root-scoped Ruff check and format check pass for all three package directories.

• All three wheels build and pass isolated import/install checks; applicable pip check and editable direct_url.json checks pass.

• Release intent and release inventory validators pass.

• All 17 paired example scripts completed under otel2-fix-py-group-21-20260817T214109Z; the PGVector live-database script reported its intended missing-DSN skip.

• Respan MCP: all 16 trace trees and all 48 full details inspected; exact roots, parents, IDs, markers, content, usage, streams, tools, errors, and privacy checked with no duplicates or credential leakage.

• Real OpenRouter provider validation passed with model openai/gpt-4o-mini, exact output, and non-estimated 15/4/19 usage.

• Full source and paired-example diffs were audited against every applicable document under contribution/; canonical span fields, OTel attribute shapes, release-intent/version ownership, and package boundaries have no remaining package-owned violation.

External follow-ups

• Current ingestion still projects OpenRouter provider, status, and tool convenience fields inconsistently and estimates usage on selected no-terminal-usage error or early-close records.
• Shared @tool input normalization, PGVector local-error classification and entity-path projection, upstream OpenAI/httpcore2 [DONE] teardown, and credential-gated PostgreSQL/pgvector runtime coverage remain separately tracked.

Companion examples

• fix(examples-py): validate OpenLIT, OpenRouter, and PGVector OTel 2.x spans respan-example-projects#69

[greptile-apps]

Your trial has ended. Reactivate Greptile to resume code reviews.