Skip to content

test(parity): shared server scenario conformance corpus + Python reference runner#62

Merged
brentrager merged 2 commits into
mainfrom
parity-scenarios
Jun 24, 2026
Merged

test(parity): shared server scenario conformance corpus + Python reference runner#62
brentrager merged 2 commits into
mainfrom
parity-scenarios

Conversation

@brentrager

Copy link
Copy Markdown
Contributor

Promotes conformance from message-shape to full server behavior — the parity oracle for the polyglot servers.

  • spec/conformance/scenarios/*.json — language-neutral scenarios (mockLlmScript + inbound frames + expected outbound event stream). Every native server runs the same corpus and must produce identical normalized output. Deterministic because each server drives the same engine MockLlmProvider script — no live model.
  • python/server/tests/test_scenario_parity.py — the ~80-line reference runner (a state machine over the corpus). Port it into the TS/Go/C#/Rust server suites; when all five run green, the servers are at protocol parity.
  • Seed scenarios: basic-streaming-turn (create → ack → stream → eventual, with token reassembly) + unknown-session-error (clean error/SESSION_NOT_FOUND). Both verified green against the Python server.

Next: port the runner into the other four server suites (TS/Go/C#/Rust) + grow the corpus (multi-turn, tool-call/HITL, citations, auth, graceful-drain).

🤖 Generated with Claude Code

…rence runner

Promotes conformance from message-shape (fixtures.json) to full server BEHAVIOR:
spec/conformance/scenarios/*.json are language-neutral scenarios (mockLlmScript +
inbound frames + expected outbound event stream) that every native server runs
identically. Deterministic across languages because each server drives the same
MockLlmProvider script. python/server/tests/test_scenario_parity.py is the ~80-line
reference runner — port it into the TS/Go/C#/Rust server suites for full parity.
Seed scenarios: basic-streaming-turn, unknown-session-error (both green vs the Python server).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01U7Mn93HpqhSgEmX6tRdPAv
@changeset-bot

changeset-bot Bot commented Jun 24, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: f90a056

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@brentrager
brentrager merged commit 232bf4f into main Jun 24, 2026
1 check passed
brentrager added a commit that referenced this pull request Jun 24, 2026
… shared parity corpus (#69)

The TS/Python/Go servers landed (#59/#60/#61) and all five now run the shared
spec/conformance/scenarios corpus (#62-#67) — tested protocol parity. Updates the
servers row + tests section from 'in progress' to the real state.


Claude-Session: https://claude.ai/code/session_01U7Mn93HpqhSgEmX6tRdPAv

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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.

1 participant