refactor(sdk)!: remove WebSockets + consolidate tooling/coverage

[EricAndrechek]

Summary

Foundation pass for the SDK/API: removes dead transport code, consolidates build/test tooling, and turns on coverage enforcement — the groundwork the feature work builds on. This PR is intentionally scoped to cleanup/infra only. The features originally planned here have been split into focused, one-PR-each sub-issues tracked under the epic #194.

What's in this PR

• Kill WebSocket support entirely — SSE becomes the single streaming transport. Removes ws.ts, ws-manager.ts, stream_ws.go; renames stream_sse.go → stream.go. (One transport is simpler to focus on, and SSE tends to work more consistently through corporate networks where WS may be blocked.) ⚠️ Breaking for any consumer on the WS transport.
• pnpm workspace consolidation — single root pnpm-workspace.yaml + lockfile (shadows stray ancestor workspace files); drops the per-project lockfiles under clients/ts, docs, tests/e2e/sdk.
• Root Makefile consolidation — one top-level Makefile (no more per-subproject docs/Makefile) with a first-class SDK target.
• biome for TS lint + format (biome.json) plus a repo-wide format pass.
• Test coverage enforcement — .testcoverage.yml, scripts/cov, vitest config, e2e fixtures moved to tests/e2e/fixtures. Closes chore(coverage): restore SDK statements coverage threshold to ≥50 #176.
• Re-enable the SSE public-events streaming test. Closes test(sdk): re-enable or delete the disabled SSE-public-events streaming test #153.
• Remove the clients/ts/playground/ scratch dir and stale PLAN.md; add editor configs (.vscode, .zed, .editorconfig).

~50% of the diff is generated lockfile churn; most of the rest is deletions and a mechanical biome reformat. The hand-written surface is small.

Feature work — moved out, tracked in #194

Split into individually-reviewable PRs so this doesn't become a mega-PR:

NDJSON upload (#195) · bounded parallel uploads (#196) · live DLQ streaming (#197) · better TS errors (#198) · builder/command restructure (#199) · cache HIT/MISS + debug internals (#200) · exported error types (#201) · auto dedupe ID (#202) · SSE auth → Fetch EventSource (#203) · live-vs-replay (#98) · multi-subscription SSE replay (#204)

Related Issues

• Closes test(sdk): re-enable or delete the disabled SSE-public-events streaming test #153
• Closes chore(coverage): restore SDK statements coverage threshold to ≥50 #176
• Tracking epic for the remaining feature work: epic(sdk): SDK feature rollout after #190 cleanup #194

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

📝 Walkthrough

Walkthrough

Consolidates SSE/WS into a single StreamHandler, removes the websocket handler and WS transport from the SDK, consolidates routing to GET /v1/stream, updates tests and E2E fixtures/orchestrator, and applies supporting tooling/config and docs changes.

Changes

Stream handler migration and routing

Layer / File(s)	Summary
StreamHandler implementation and routing internal/api/stream.go, internal/api/router.go	Introduce StreamHandler, move replay/policy helpers to it, add multiplexing TODO, and change /v1/stream route to use StreamHandler.Handle; update Dependencies and tracing skip comment.
Router tests dependency wiring internal/api/router_test.go	Update router-focused tests to construct NewStreamHandler(...) instead of NewSSEHandler(...) across multiple testcases.
Remove WS handler and update unit tests internal/api/stream_ws.go (removed), internal/api/stream_test.go	Remove websocket-specific code and its WS unit test; update stream unit tests to use StreamHandler and path /v1/stream.
Binary and integration wiring cmd/wavehouse/main.go, tests/integration/setup_test.go	Create and wire StreamHandler in the main binary, assign shared PolicyStore, and update integration test server wiring to drop WS and use NewStreamHandler(...).

Client/SDK transport and tests

Layer / File(s)	Summary
TS client runtime and SSE transport clients/ts/src/client.ts, clients/ts/src/stream/sse.ts	Remove WebSocket manager/imports, add EventSource availability guard and updated error text, and change SSE EventSource URL to /v1/stream.
Public API types and exports clients/ts/src/index.ts, clients/ts/src/types.ts	Remove SharedWSManager re-export and remove transport from ClientConfig/StreamOptions.
TS tests and coverage clients/ts/src/stream/controller.test.ts, clients/ts/vitest.config.ts	Adjust stream controller tests to new error semantics and update Vitest coverage excludes to only test files.

E2E, orchestrator, playground, and fixtures

Layer / File(s)	Summary
E2E streaming tests tests/e2e/sdk/streaming.test.ts	Re-enable/refactor SSE E2E tests to call stream() without explicit transport and ensure try/finally teardown with optional unsub and stream.close().
Orchestrator and fixtures scripts/orchestrator/main.go, tests/e2e/fixtures/config.yaml	Orchestrator runs WaveHouse from repo root using WH_CONFIG YAML; add e2e fixture config.yaml with CORS, MQ, dedupe, JWT, schema refresh, DLQ, policy file, and OTel settings.
Playground and compose removals clients/ts/playground/*, tests/e2e/compose.yaml	Remove playground example scripts and compose artifacts used by SDK examples.

Tooling and module changes

Layer / File(s)	Summary
Makefile and golangci-lint Makefile	Add --allow-parallel-runners to golangci-lint run in lint and fix targets.
go.mod go.mod	Remove github.com/coder/websocket requirement.
Test coverage thresholds .testcoverage.yml	Raise per-suite minima for unit, integration, and e2e thresholds.

Docs and marketing

Layer / File(s)	Summary
API and SDK docs docs/src/content/docs/api.md, docs/src/content/docs/sdk.md	Document GET /v1/stream and ?token= behavior (header precedence, stripping), remove WebSocket upgrade caveat, and remove transport option from SDK docs.
Architecture and marketing pages docs/src/content/docs/architecture.md, docs/src/content/docs/why-wavehouse.md, README.md, AGENTS.md	Remove WebSocket references from architecture/diagrams and marketing text; change diagrams and examples to the consolidated SSE /v1/stream route.

🎯 4 (Complex) | ⏱️ ~45 minutes

---

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Pro by visiting https://app.coderabbit.ai/login.

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[gemini-code-assist]

Summary of Changes

Hello, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request initiates a series of large-scale improvements to the SDK and API, focusing on developer experience, type safety, and error handling. The current changes focus on optimizing the development environment and restoring test coverage for core streaming features, setting the stage for broader architectural updates.

Highlights

• CI/CD Optimization: Updated the Makefile to enable parallel runners for golangci-lint, improving the efficiency of linting tasks.
• Test Coverage: Re-enabled skipped end-to-end tests for SSE and WebSocket streaming functionality in the SDK.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize the Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counterproductive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

This pull request configures golangci-lint to allow parallel runners in the Makefile and re-enables previously skipped end-to-end tests for SSE and WebSocket streaming. The review feedback correctly identifies that these newly enabled tests do not clean up their streams and subscriptions if an assertion fails or a timeout occurs. It is recommended to wrap the test logic in try...finally blocks to guarantee proper resource cleanup and prevent connection leaks.

[taitelee]

Reviewed go file modifications and doc edits related to removing websocket support. Looks good. There does not seem to be dangling/outdated references to it.