OpenHands / OpenHands/software-agent-sdk

Streaming step 7: stop emitting StreamingDeltaEvent and freeze the legacy events endpoint

Open
#4,683 1 comment 0 reactions 1 assignee View on GitHub

@VascoSch92 is already working on this.

Since Aug 27, 2026.

architecture enhancement ready-for-dev
Dominant language
Python
Stars
1.1k
Forks
542
Avg merge
1d 19h
Merged PRs (30d)
137

Description

Part of #4671 (step 7). Needs step 6.

Desired Behavior

Once every client speaks the session endpoint, stop producing the old channel.

Work

  1. Stop emitting StreamingDeltaEvent. Deltas become progress frames on the session socket only. This is what structurally retires the two unfiled bugs: nothing left for telemetry to count, nothing left for webhooks to POST. Any interim kind filter added earlier can come out with it.
  2. Freeze /sockets/events/{id} and announce its removal. Nothing decodes wrong — it just stops being offered.
  3. Remove the legacy resend_mode / after_timestamp replay parameters, superseded by the after_seq cursor.

Why it is last

Every client has to have switched first, which is step 6 plus the two client PRs. Until then the old endpoint is the only thing some clients speak.

Acceptance Criteria

  • StreamingDeltaEvent has no construction site.
  • A webhook receives the same event count for a streamed and non-streamed conversation, with no filter in the path.
  • The legacy endpoint is documented as deprecated with a removal target.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.