fix(instrumentation-py): repair Pinecone, Pipecat, and Portkey OTel 2.x spans

[Nightingalelyy]

Summary

• Repair Pinecone, Pipecat, and Portkey translation, lifecycle, streaming, error, bounded-serialization, privacy, and canonical semantic-convention behavior on the current OTel Python stack.
• Add real current-SDK exported-span regressions for Pinecone 9.1, Pipecat 1.7/OpenInference 2.0.1, and Portkey 2.3.4.
• Add the patch release intent for exactly these three instrumentation packages.

Validation

• Focused package tests pass: Pinecone 4/4, Pipecat 13/13, Portkey 12/12 (29/29).

• Root-config Ruff check and format check pass for all changed package source and tests.

• All three wheels build and import from isolated install targets: Pinecone 6d3f2895…96a0, Pipecat ed916fa4…4f92, Portkey 74ebb454…994b.

• Release inventory, release-intent validation, missing-intent validation, and diff checks pass.

• Companion locally linked examples pass all 11 executed scenarios under otel2-fix-py-group-22-20260817T230705Z.

• Respan MCP returned exactly 11 traces / 31 full records; every tree and detail was inspected for roots, parents, IDs, content, model/provider, exact/non-estimated success usage, streaming, tools, failures, grouping, payload bounds, aliases, and credential leakage.

• Pipecat success usage is provider-supplied and non-estimated at offline 8/6/14 and live 18/7/25; Portkey streaming is stream=true with exact 7/5/12.

• 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 Pinecone's native OTel 503 as success/200 and leaves the outer decorated Pipecat/Portkey failure roots success/200 while package-owned descendants are correctly failed/401.
• Portkey convenience tools/tool_calls and provider ID remain incomplete despite canonical attributes, current-turn call content, and a connected tool child.
• Error-only Pipecat/Portkey records receive backend-estimated tokens when no provider terminal usage exists.
• Pinecone operation nodes remain visibly named task per the contribution task-display contract; exact operation identity remains canonical in entity/database attributes.
• Live Portkey gateway-specific coverage remains credential-gated.

Companion examples

• respan-example-projects #70

[greptile-apps]

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