Skip to content

chore(runtime-host): retire the legacy surface hello shim after epoch 27 #3297

Description

@Sun-GLiang

Summary

PR #3277 removes ClientSurface from the Runtime Host protocol and connection plumbing, while retaining one private outgoing hello shim that sends surface: "desktop" for pre-#3277 Hosts.

Track removal of that shim once the compatibility boundary is observable on the wire.

Removal gate

Remove the shim only when all of the following are true:

  • the minimum supported Runtime Host compatibility epoch is greater than 27;
  • the removal change bumps the Client compatibility epoch accordingly;
  • mixed-version coverage verifies that unsupported older Hosts reach the structured incompatible / restart-guidance path rather than failing with a bare transport abort.

Epoch 27 cannot distinguish a pre-#3277 Host that requires surface from a post-#3277 Host that tolerates its absence, so release notes alone are not a safe removal signal.

Related

AI assistance disclosure: Codex helped analyze the mixed-version failure mode and draft this tracking issue.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requesthelp wantedExtra attention is needed

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions