Skip to content

docs(cua-driver): accept every supported platform in the history event schema - #3223

Merged
f-trycua merged 1 commit into
mainfrom
fix-history-schema-platform
Aug 17, 2026
Merged

docs(cua-driver): accept every supported platform in the history event schema#3223
f-trycua merged 1 commit into
mainfrom
fix-history-schema-platform

Conversation

@f-trycua

Copy link
Copy Markdown
Collaborator

Summary

  • widen data.platform in the published Computer History event schema from {"const": "macos"} to the set the emitter actually produces

The schema predates the Windows/Linux extension in #3189. platform_name() in history_runtime.rs returns exactly one of macos | windows | linux, so any consumer validating real events against the published v0 schema rejects everything produced off macOS.

Validation

  • schema parses as valid JSON after the edit
  • verified against a live Windows event from cua-driver 0.20.1-nightly.20260817.31994594712, which carries "platform": "windows" and previously failed validation
  • enum mirrors platform_name() exactly, so no value can validate that the emitter cannot produce

Scope

Documentation only, no product behavior change — docs: type, non-releasing.

The two substantive Windows bugs found in the same investigation are filed separately and are not addressed here: #3220 (history records no action events when the MCP host predates history enable) and #3221 (ApplicationFrameHost-hosted apps all attribute to the host).

Note for reviewers

Opened for review, not merged. The desktop E2E matrix in AGENTS.md has not been run for this change; it is docs-only, so please confirm whether that gate applies before merging.

Closes #3222

🤖 Generated with Claude Code

…t schema

The published Computer History event schema still pins `data.platform` to
`{"const": "macos"}`, which predates the Windows and Linux extension in #3189.
Both adapters emit `"windows"` and `"linux"`, so any consumer validating real
events against the published v0 schema rejects every event produced off macOS.

Observed on Windows with cua-driver 0.20.1-nightly.20260817.31994594712:

    "platform": "windows"

`platform_name()` in history_runtime.rs returns exactly one of
`macos | windows | linux`, so the enum mirrors the emitter.

Refs #3189

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@cursor

cursor Bot commented Aug 17, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@f-trycua
f-trycua merged commit 745c43b into main Aug 17, 2026
7 checks passed
@f-trycua
f-trycua deleted the fix-history-schema-platform branch August 17, 2026 13:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Published history event schema pins data.platform to macOS and rejects every Windows/Linux event

1 participant