Skip to content

Turnspan upstream status

Turnspan 2 audit

This November 19, 2026 snapshot covers all open issues and pull requests in OpenAI's ChatKit Python repository. We checked them against Turnspan 2 (1.6.5+turnspan.2, commit 4c7ba49) on Python 3.14. The release CI passed 164 tests. The table also counts fixes verified on the maintained Python 3.14 branch and included in Turnspan 3. Open issues · Open pull requests · Turnspan 2 release · Release CI

Decision Issues PRs Entries Distinct topics
Resolved on Turnspan 5 13 18 13
Deferred 2 1 3 3
Reviewed, no fix needed 4 1 5 5
Total reviewed 11 15 26 21

The maintained branch resolves 18 of 26 entries (69%) across 13 of 21 topics (62%). Turnspan 2 shipped fixes for 15 entries across 11 topics. Turnspan 3 includes the test collection and web-search progress fixes. Entries count individual GitHub reports and patches. Topics count each underlying behavior once. The fixed count includes code, docs, and tooling changes that fully address the reported need.

Resolved in Turnspan 2

Topic What we verified and shipped
Stream cleanup after disconnect In the early-close reproduction, upstream left a pending stream read and Turnspan cleaned it up. The HTTP regression also verifies that the partial reply reloads and the thread accepts a new turn. Issue #138 · PR #133 · Cleanup · HTTP regression
Distinct Chat Completions reply IDs Two replies keep separate IDs from streaming through thread reload. The Responses path preserves the IDs supplied by OpenAI. Issue #36 · PR #128 · Fix and tests
ListView inside a Card Both PRs address the same missing widget type. The release preserves typed rows and click actions through serialization. We also rendered the nested list, clicked a row, and reloaded the thread in a browser. Issue #47 · PR #46 · PR #137 · Fix and test
Streamed citations The converter accepts the SDK's dictionary-shaped citation payloads. A regression verifies that an empty citation is skipped and the next valid citation still arrives. PR #129 · Citation conversion · Empty citation regression
Text updates without component IDs Tests confirm that text appended to static and dynamic widgets without IDs reaches the client through a replacement update. PR #132 · Fix and tests
Added or removed widget properties Tests confirm that both added and removed dynamic properties produce a replacement with the correct widget data. PR #134 · Fix and tests
Equal workflow tasks get distinct positions Appending a task uses its new position even when an earlier task has the same title and content. Tests cover equal and different tasks. PR #135 · Fix and tests
Agents SDK header overrides Removing automatic User-Agent tagging eliminated Turnspan's temporary override. Tests checked the SDK default header on Responses and an app-configured header on Chat Completions. PR #136 · Removal and tests
Quickstart backend verification The quickstart now includes a curl smoke test. We ran its request against the documented FastAPI backend without an API key and got a completed event containing Hello, world!. PR #118 · Quickstart smoke test · Docs change
Structured output persistence The guide shows how to save structured tool results after a successful stream, with an upsert keyed to the thread and user message. A scripted Agents SDK run exercised a successful save and verified that a failed turn skips it. Issue #120 · Persistence example
GitHub Actions setup-uv update The PR proposes setup-uv v7. Turnspan 2 pinned v10.3.3 by commit and passed CI. The maintained branch builds and publishes docs from the CI workflow. PR #84 · Workflow pins

Resolved after Turnspan 2

Topic What we verified on the Python 3.14 branch
Test imports in a clean checkout Fixed. Shared server and stream helpers live in tests/helpers/, and plain pytest defaults to importlib mode. All nine test modules collected individually, and CI passed all 164 tests. Turnspan 2 had already removed the private Agents SDK sentinel import. Thanks to Mark Zhang for reporting the import problem. PR #122 · Test setup · Passing CI run · Fixture cleanup
Web-search progress Fixed. Each Responses search keeps its own task and completion state by provider item ID. The regressions exercise overlapping searches, cancellation, and final citations. Chrome replay with synthetic Responses events verified independent progress and completion, a working Stop button, and the final citation inline and in the Sources drawer. Thanks to Francis Poisson-Gagnon for the report and proposed patch. Issue #28 · PR #29

Deferred

Topic What we verified and why it is deferred
Mypy checks on the SDK source Mypy 2.4.1 on Python 3.14 reports 27 errors in three Turnspan source files. A smoke check importing public types from an installed Turnspan wheel passes, as does the supported Pyright check. Revisit if an app demonstrates a typing blocker or Turnspan adopts mypy as a supported checker. PR #7
Large inline PDF persistence The mocked transport captured an inline PDF in a request to /v1/responses and zero Files API requests. The hosted service's storage behavior and the reported size threshold still need verification on the Responses API side. Issue #109
Report without a ChatKit reproduction The report provides no ChatKit behavior or reproduction steps to test. Revisit when an example identifies a failing SDK operation. Issue #130

Reviewed, no fix needed

Topic What we verified and why Turnspan needs no change
Node.js and TypeScript backend The issue requests a separate server SDK. The maintainer's reply discusses an official Node backend and community ports. Turnspan maintains the Python server SDK. Issue #5 and maintainer reply
Custom browser components The maintainer's reply identifies browser rendering as the area that would need support for custom UI. Any Python-side schema change would need a supported renderer contract first. Issue #53 and maintainer reply
Citation formatting in hosted Agent Builder The reporter confirmed that the problem occurs in hosted Agent Builder. Turnspan's self-hosted citation fix addresses the SDK stream described in PR #129. Issue #124 and reporter clarification
OpenAI maintenance status and roadmap This is a question for the maintainers of the original repo. Turnspan can publish its own release and triage status. The issue describes no SDK behavior to change. Issue #139

PR #21 — API reference URLs and Pylint

Reviewed, no fix needed. We kept /api/chatkit/ because the navigation, reference overview, and guides link to modules at that path. It also matches OpenAI's published reference. Zensical generates the same routes on Turnspan. The PR proposes moving the generated pages to /chatkit/chatkit/. Its separate Pylint workflow targets Python 3.8–3.10, below Turnspan's Python 3.14 baseline. PR #21 diff · Published API reference

We ran mkdocs build --strict in two clean copies of Turnspan 2 (4c7ba49). The release passed with zero build warnings. Applying only the proposed URL change moved generated pages such as server/ to the new path. The sidebar and guide links still pointed to the old paths. The strict build failed with 45 warnings. PR #21 is excluded from the fixed count.