[build-tools] Upload the agent-device screenshot display rotation as artifact metadata

[szdziedzic]

Why

agent-device screenshots in EAS device run sessions carry no information about device rotation. A consumer cannot tell a landscape capture from a portrait one without decoding the image, and it cannot tell landscape-left from landscape-right at all.

agent-device now reports displayRotation (portrait, portrait-upside-down, landscape-left, or landscape-right) on screenshot entries in its /artifacts inventory. This is the rotation the display rendered the capture in. The saved image is always upright, so a landscape value pairs with a landscape image. The agent-device change: callstack/agent-device#3088.

How

• AgentDeviceArtifactSchema reads the optional displayRotation field. An unknown value is dropped through .catch(undefined), so a newer daemon value cannot fail the whole inventory parse and block uploads.
• uploadAgentDeviceArtifactAsync passes it as metadata: { displayRotation } on the existing createArtifactUploadSession input. An artifact without the field uploads no metadata, as before.

This is safe to merge before agent-device releases the field: older daemons omit it.

Test Plan

• Added tests in agentDeviceArtifacts.test.ts: a known value is kept and an unknown one dropped, the value is uploaded as metadata, and no metadata is sent without it. 10 of 10 pass.
• oxfmt passes on the changed files.
• Not tested on a live EAS Simulator session. The agent-device side was verified live on an iOS simulator and an Android emulator (GET /artifacts returned displayRotation).
• The dashboard does not read metadata.displayRotation yet.

🤖 Generated with Claude Code

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 73.71%. Comparing base (817d06e) to head (b97a0f5).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4508      +/-   ##
==========================================
+ Coverage   73.71%   73.71%   +0.01%     
==========================================
  Files         998      998              
  Lines       48775    48777       +2     
  Branches    10545    10547       +2     
==========================================
+ Hits        35950    35952       +2     
  Misses      11831    11831              
  Partials      994      994              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

✅ Thank you for adding the changelog entry!

[krystofwoldrich]

Nice. And because the agent device uses the latest, this just starts working correctly.