[brightsparc]

Why

GET /v1/conversations/{id}/items gains two server-side filters in introspection-org/introspection-cloud#3524 so a chat client reads only the rows it renders: a repeatable operation_name (any of) and content, a closed set of content classes resolved from a plaintext summary stamped at ingest. The export route gains the repeatable operation_name only. This SDK took operation_name as one string and had no content. Nothing is removed: this SDK never exposed /turns.

Change

• items.list() takes operation_name as str | list[str] (a list is sent as the repeated key, any of which matches) and a content: list[str] of classes: user_text, assistant_text, delegation, tool:<name>, tool_call:<name>, tool_result:<name>. Its docstring says how the two combine.
• export_trajectory(), export_arrow(), build_export_params() and ConversationExportParams take operation_name as str | list[str]; no content, since the export route has none.
• IntrospectionAttributes.content: IntrospectionContent | None types the introspection.content.* summary (version, counts, tool-name arrays; never message content); exported from schemas.genai_span.
• Sync twins regenerated with scripts/gen_sync.py.

The only type change on an existing name is the widening of operation_name from str to str | list[str]; griffe check against v0.29.1 reports no breakage.

Verification

• ruff format, ruff check, ty check, deptry clean; jscpd 16.03 % against the 16.3 % threshold.
• pytest tests/ 778 passed, coverage 92.4 % against the 80 % floor. New cases: repeated operation_name and content keys on the items list, a single operation_name unchanged, the typed content summary on an item, and the repeated operation_name with no content on the trajectory export.
• griffe check introspection_sdk --search . --against v0.29.1 -e scripts/griffe_reexports.py: no breakage.

Review round

Codex: the export carried a content the server ignores. Removed in the last commit.

Related

• introspection-org/introspection-cloud#3524 (the API), feat!: select conversation items by content class and drop turns introspection-js-sdk#516, feat!: select conversation items by content class and drop turns introspection-swift-sdk#55, feat(conversations)!: repeat operation_name and add the content filter on items introspection-rust-sdk#143.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Hj7wRZSdedpuVRaKkxsHuF