Repository navigation
Specify optional conversation history deltas - #83
Open
Stephen Belanger (Qard) wants to merge 16 commits into
Open
Stephen Belanger (Qard) wants to merge 16 commits into
Stephen Belanger (Qard) wants to merge 16 commits into
Conversation
Stephen Belanger (Qard)
requested review from
Abhijeet Prasad (AbhiPrasad) and
Andrew Kent (realark)
November 11, 2026 17:05
Stephen Belanger (Qard)
marked this pull request as ready for review
November 11, 2026 17:05
Andrew Kent (realark)
approved these changes
Nov 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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/outputfields map to the proposed OTel semantics. History correlation reuses the existinggen_ai.conversation.idmapping tometadata.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) andgit diff --checkpassed 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.