Skip to content

Specify optional conversation history deltas - #83

Open
Stephen Belanger (Qard) wants to merge 16 commits into
mainfrom
design/history-sequence-reporting
Open

Stephen Belanger (Qard) wants to merge 16 commits into
mainfrom
design/history-sequence-reporting

Conversation

@Qard

@Qard Stephen Belanger (Qard) commented Nov 5, 2026 •

Copy link
Copy Markdown
Contributor

Specifies optional conversation-history deltas following OpenTelemetry proposal #364. Full reporting retains no comparison history; delta mode sends new messages between complete checkpoints and resets on edits, compaction, or lost state.

The spec covers output reuse, readback, bounded optional state, and forks starting with a full checkpoint under a distinct stable conversation ID. Native input / input_delta / output fields map to the proposed OTel semantics. History correlation reuses the existing gen_ai.conversation.id mapping to metadata.conversation_id. Ordering reuses source timestamps and span parentage, with full snapshots for ambiguity and receiver re-evaluation after late delivery; no new grouping or predecessor field is required. Slice support is possible future work, with no slice codec required initially. No reporting behavior is enabled by this PR.

Validation: make test (45 tests) and git diff --check passed locally. Tests cover snapshots, appends, non-append resets, interleaved forks, mode changes, missing context, metadata-based identity, and replay. Real backend/transport integration remains implementation work.

@Qard Stephen Belanger (Qard) changed the title Propose shared history sequences for span reporting Specify optional conversation history deltas Nov 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants