Run Cursor SDK through the shared facade in evals and the example

Merged
GI
2mo ago
+2399-1108

Replace Cursor CLI execution with the Cursor SDK on the shared Stagehand facade mount, and retain the runnable integration contributed in #2771. The eval harness and documented example share one SDK session implementation for settings isolation, tool events, cancellation, and cleanup.

Stack base: the harness contract adoption PR (evals/consolidation-13-harness-contract-adoption). This existing #2889 takes the planned Cursor replacement position; no additional Cursor PR is needed.

The example keeps its docs, icon, MCP/stdio entrypoint, isolated workspace, and SIGINT/SIGTERM handling. It now consumes the shared SDK instead of maintaining a second agent lifecycle. The shared SDK accepts an explicit API key for hosts that supply an isolated environment.

Validation: 64 focused tests pass (28 SDK, 19 example, 17 eval boundary); SDK/dependency and eval CLI/ESM builds, three package typechecks, scoped format/lint, and changeset validation pass. No new live browser/model validation is claimed here.

Original contribution: @antonvishal, #2771, source head 7b1d52d117c92bbda79a4b3cce6775ff60154712, approved and claimed by @miguelg719. Contributor ancestry is preserved through normal merges. Follow-up integration changes are maintained manually on this internal branch as part of the consolidation stack; do not trigger an external-source mirror refresh for these follow-ups.

Current open stack: #2893 → #2894 → #2902 → #2903 → #2889 → #2904 → #2905 → #2906 → #2907.