v21.4.0

[eas-cli] Support naming simulator sessions (#4099 )
* [eas-cli] Support naming simulator sessions * [eas-cli] Trim the simulator session name flag
2026-11-14 10:08:06 -10:00 · 2026-07-28 10:18:26 +00:00 · 2026-07-28 12:14:06 +02:00 · 2026-07-28 11:10:02 +02:00 · 2026-07-27 18:25:17 -07:00 · 2026-07-27 16:24:00 +02:00
52 changed files with 4213 additions and 545 deletions
@@ -30,15 +30,17 @@
  "breakGlass": { "marker": "/skip-review" },
  "commentTag": "expo-ai-code-reviewer",

-  // ChatGPT/Codex subscription (OAuth): tokenEnv holds the REFRESH token from an
-  // `opencode auth login` ChatGPT sign-in (copy `.openai.refresh` out of OpenCode's
-  // auth.json); OpenCode mints short-lived access tokens from it on demand. All
-  // models above are on the subscription's allowlist, so reviews draw no metered
-  // spend. (To add pro-tier models later, see the mixed auth.providers setup in
-  // the @expo/code-review-cli README.)
+  // ChatGPT/Codex subscription (OAuth): tokenEnv holds the ACCESS token from an
+  // `opencode auth login` ChatGPT sign-in (`ecr setup-auth` extracts it) — a
+  // plain bearer with no rotation involvement; re-mint before its ~10-day expiry
+  // (doctor + the run preflight warn first). NEVER use the refresh token here:
+  // it is single-use and dies on first rotation. All models above are on the
+  // subscription's allowlist, so reviews draw no metered spend. (To add pro-tier
+  // models later, see the mixed auth.providers setup in the @expo/code-review-cli
+  // README.)
  "auth": {
    "mode": "oauth",
    "provider": "openai",
-    "tokenEnv": "CODEX_OAUTH_REFRESH_TOKEN"
+    "tokenEnv": "CODEX_OAUTH_ACCESS_TOKEN"
  }
 }
@@ -0,0 +1,31 @@
+<svg width="128" height="128" viewBox="0 0 128 128" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_1887_635)">
+<rect width="128" height="128" rx="64" fill="#18191B"/>
+<path d="M99.6237 27.9758C119.134 47.4859 119.024 79.2583 99.3412 98.9413C79.6583 118.624 47.8858 118.734 28.3758 99.2237C8.86596 79.7136 8.976 47.9418 28.6589 28.2589C48.3418 8.57602 80.1136 8.46598 99.6237 27.9758Z" stroke="url(#paint0_linear_1887_635)" stroke-width="3.24"/>
+<path d="M114.38 64C114.38 72.6638 109.008 80.7192 99.8828 86.6855C90.7722 92.6425 78.0904 96.3799 64 96.3799C49.9096 96.3799 37.2278 92.6425 28.1172 86.6855C18.9922 80.7192 13.6201 72.6638 13.6201 64C13.6201 55.3362 18.9922 47.2808 28.1172 41.3144C37.2278 35.3575 49.9096 31.6201 64 31.6201C78.0904 31.6201 90.7722 35.3575 99.8828 41.3145C109.008 47.2808 114.38 55.3362 114.38 64Z" stroke="url(#paint1_linear_1887_635)" stroke-width="3.24"/>
+<path d="M64 13.6201C72.6638 13.6201 80.7192 18.9922 86.6855 28.1172C92.6425 37.2278 96.3799 49.9096 96.3799 64C96.3799 78.0904 92.6425 90.7722 86.6855 99.8828C80.7192 109.008 72.6638 114.38 64 114.38C55.3362 114.38 47.2808 109.008 41.3145 99.8828C35.3575 90.7722 31.6201 78.0904 31.6201 64C31.6201 49.9096 35.3575 37.2278 41.3145 28.1172C47.2808 18.9922 55.3362 13.6201 64 13.6201Z" stroke="url(#paint2_linear_1887_635)" stroke-width="3.24"/>
+<path d="M66.0082 42.48H61.9918C60.1376 42.48 58.4378 43.4711 57.5835 45.0503L40.5592 76.5206C40.164 77.2512 40.1343 78.1142 40.4784 78.8683L41.8881 81.9568C42.7652 83.8787 45.527 84.0723 46.6859 82.2932L62.8238 57.5187C63.0773 57.1295 63.5218 56.8932 64 56.8932C64.4782 56.8932 64.9227 57.1295 65.1761 57.5187L81.3141 82.2932C82.473 84.0723 85.2348 83.8787 86.1119 81.9568L87.5215 78.8683C87.8657 78.1142 87.836 77.2512 87.4408 76.5206L70.4165 45.0503C69.5622 43.4711 67.8624 42.48 66.0082 42.48Z" fill="url(#paint3_linear_1887_635)"/>
+</g>
+<rect x="1" y="1" width="126" height="126" rx="63" stroke="white" stroke-opacity="0.3" stroke-width="2"/>
+<defs>
+<linearGradient id="paint0_linear_1887_635" x1="112.4" y1="20.4" x2="138.422" y2="-10.3513" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white"/>
+</linearGradient>
+<linearGradient id="paint1_linear_1887_635" x1="130" y1="88" x2="233.2" y2="134.8" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white"/>
+</linearGradient>
+<linearGradient id="paint2_linear_1887_635" x1="86" y1="30.4" x2="130.8" y2="-75.2" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white"/>
+</linearGradient>
+<linearGradient id="paint3_linear_1887_635" x1="64" y1="84" x2="64" y2="210.5" gradientUnits="userSpaceOnUse">
+<stop stop-color="white"/>
+<stop offset="1" stop-color="white" stop-opacity="0"/>
+</linearGradient>
+<clipPath id="clip0_1887_635">
+<rect width="128" height="128" rx="64" fill="white"/>
+</clipPath>
+</defs>
+</svg>
@@ -19,7 +19,7 @@ permissions:

 env:
  # Published reviewer run via npx (override with repo variable ECR_VERSION).
-  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.5.0' }}
+  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.6.0' }}

 concurrency:
  group: ai-code-review-cmd-${{ github.event.issue.number }}
@@ -77,12 +77,18 @@ jobs:
      # config, and never `gh pr checkout` the PR head. The reviewer engine itself
      # is the PUBLISHED @expo/code-review-cli (fetched by npx), not built from any
      # checkout, so attacker-controlled PR code never runs here. The diff + PR
-      # metadata come from the API (`gh pr diff`/`gh pr view`).
+      # metadata come from the API (`gh pr diff`/`gh pr view`); `ecr ci` (0.6.0+)
+      # loads configuration from the PR's immutable base commit and reads source
+      # from a head worktree scrubbed of ambient runtime config — the same trust
+      # model as the pull_request workflow.
      - name: Checkout (base ref only — never the PR head)
        if: steps.cmd.outputs.run == 'true'
        uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
        with:
          fetch-depth: 1
+          # The CLI's git fetches authenticate through `gh` from GH_TOKEN; keep the
+          # token out of .git/config.
+          persist-credentials: false

      # Corepack so setup-node's yarn probe doesn't fail on the repo's yarn@4 pin
      # (the reviewer runs via npx, not yarn).
@@ -104,8 +110,8 @@ jobs:
        continue-on-error: true
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          CODEX_OAUTH_REFRESH_TOKEN: ${{ secrets.CODEX_OAUTH_REFRESH_TOKEN }}
-          ECR_EXPECTED_TOKEN_ENV: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_REFRESH_TOKEN' }}
+          CODEX_OAUTH_ACCESS_TOKEN: ${{ secrets.CODEX_OAUTH_ACCESS_TOKEN }}
+          ECR_EXPECTED_TOKEN_ENV: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_ACCESS_TOKEN' }}
          REVIEWER_MODEL: ${{ vars.REVIEWER_MODEL }}
          AGENTS: ${{ steps.cmd.outputs.agents }}
          ROUTE: ${{ steps.cmd.outputs.route }}
@@ -18,7 +18,7 @@ permissions:

 env:
  # Published reviewer run via npx (override with repo variable ECR_VERSION).
-  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.5.0' }}
+  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.6.0' }}

 concurrency:
  group: ai-code-review-dismiss-${{ github.event.issue.number }}
@@ -80,6 +80,9 @@ jobs:
        uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
        with:
          fetch-depth: 1
+          # The CLI's git fetches authenticate through `gh` from GH_TOKEN; keep the
+          # token out of .git/config.
+          persist-credentials: false

      # Corepack so setup-node's yarn probe doesn't fail on the repo's yarn@4 pin
      # (dismiss runs the CLI via npx, not yarn).
@@ -13,8 +13,9 @@ permissions:
 env:
  # The reviewer is the published @expo/code-review-cli package, run via npx — the
  # repo only carries the `.expo-code-review/` config, not the engine source.
-  # Override with a repo variable ECR_VERSION to pin/bump; defaults to 0.5.x.
-  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.5.0' }}
+  # Override with a repo variable ECR_VERSION to pin/bump; defaults to 0.6.x
+  # (0.6.0 = trusted base-commit configuration + PR-head runtime-config scrub).
+  ECR_VERSION: ${{ vars.ECR_VERSION || '^0.6.0' }}

 concurrency:
  group: ai-code-review-${{ github.event.pull_request.number }}
@@ -77,36 +78,22 @@ jobs:
          echo "agents=$agents" >> "$GITHUB_OUTPUT"
          echo "route=$route" >> "$GITHUB_OUTPUT"

-      - name: Checkout
+      # SECURITY: check out the PR's immutable BASE commit, never the PR head or
+      # merge ref — everything on this runner's disk comes from a commit that
+      # already merged. `ecr ci` (0.6.0+) additionally enforces this itself: it
+      # materializes the base commit via the GitHub API for configuration and the
+      # head commit (OID-pinned, scrubbed of ambient runtime config like
+      # opencode.json/plugins/AGENTS.md/.env) for source reads. persist-credentials
+      # off — the CLI's git fetches authenticate through `gh` from GH_TOKEN, so the
+      # token never lands in .git/config.
+      - name: Checkout (base commit only — never the PR head)
        if: steps.resolve.outputs.run == 'true'
        uses: actions/checkout@fbc6f3992d24b796d5a048ff273f7fcc4a7b6c09 # v5
-        # The reviewer reads the working tree at HEAD and gets the diff from the
-        # API (`gh pr diff`), so a shallow checkout is enough — no full history.
+        # The diff comes from the API (`gh pr diff`), so a shallow checkout is enough.
        with:
+          ref: ${{ github.event.pull_request.base.sha }}
          fetch-depth: 1
-
-      # SECURITY: this pull_request workflow checks out the PR's code, which includes
-      # .expo-code-review/config.jsonc. Its `auth.tokenEnv` names the env var the CLI
-      # forwards as the model credential, so a PR could repoint it at another secret
-      # in the runner. Refuse to run unless tokenEnv is the expected value. That value
-      # comes from the workflow default / a repo variable — NOT from the PR's diff — so
-      # a config-only change can't move it, and the first PR that introduces the config
-      # passes because its tokenEnv already matches the default. (Backstop: the
-      # published CLI's own denylist refuses GITHUB_TOKEN/cloud-cred names regardless.
-      # Full fix: load config from the trusted base ref once this reviewer is on the
-      # default branch — see ROADMAP.)
-      - name: Guard config.jsonc tokenEnv
-        if: steps.resolve.outputs.run == 'true'
-        env:
-          EXPECTED: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_REFRESH_TOKEN' }}
-        run: |
-          values=$(grep -oE '"tokenEnv"[[:space:]]*:[[:space:]]*"[A-Za-z0-9_]+"' .expo-code-review/config.jsonc | sed -E 's/.*"([A-Za-z0-9_]+)"$/\1/')
-          count=$(printf '%s\n' "$values" | grep -c .)
-          if [ "$count" != "1" ] || [ "$values" != "$EXPECTED" ]; then
-            echo "::error::.expo-code-review/config.jsonc auth.tokenEnv must be \"$EXPECTED\" (found: \"${values:-none}\"). Refusing to run so a PR can't redirect which secret is forwarded to the model provider."
-            exit 1
-          fi
-          echo "config tokenEnv OK: $values"
+          persist-credentials: false

      # eas-cli pins yarn@4 via package.json "packageManager", so actions/setup-node's
      # environment probe runs `yarn` and the global yarn 1.x refuses unless corepack
@@ -126,6 +113,20 @@ jobs:
          # tries to save an empty yarn cache and errors ("path(s) ... do not exist").
          package-manager-cache: false

+      # SECURITY: the TRUSTED BASE checkout above includes .expo-code-review/
+      # config.jsonc, whose auth.tokenEnv names the env var the CLI forwards as the
+      # model credential. `ecr verify-config` is the canonical guard (ships with the
+      # CLI): it sweeps every config (root + routing + all scopes, referenced or
+      # not) with the engine's real JSONC parser and refuses unless tokenEnv appears
+      # exactly once, in a ROOT-owned file, equal to ECR_EXPECTED_TOKEN_ENV — so a
+      # config change can't repoint it at another runner secret or sneak in a
+      # JSON-escaped key. Layer 2; layer 1 is the same runtime lock inside `ecr ci`.
+      - name: Guard config tokenEnv (root + routing + all scopes)
+        if: steps.resolve.outputs.run == 'true'
+        env:
+          ECR_EXPECTED_TOKEN_ENV: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_ACCESS_TOKEN' }}
+        run: npx --yes -p "@expo/code-review-cli@$ECR_VERSION" ecr verify-config
+
      - name: Run AI review
        if: steps.resolve.outputs.run == 'true'
        # npx installs @expo/code-review-cli and its deps (incl. the `opencode`
@@ -135,13 +136,14 @@ jobs:
        env:
          # GitHub token scoped by the permissions block above (PR comments only).
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          # ChatGPT/Codex subscription refresh token (auth.mode "oauth" in
-          # .expo-code-review/config.jsonc reads this env var); OpenCode mints
-          # access tokens from it. All reviews run on the subscription.
-          CODEX_OAUTH_REFRESH_TOKEN: ${{ secrets.CODEX_OAUTH_REFRESH_TOKEN }}
+          # ChatGPT/Codex subscription ACCESS token (auth.mode "oauth" in
+          # .expo-code-review/config.jsonc reads this env var) — used as-is, no
+          # rotation involvement; re-mint before its ~10-day expiry. All reviews
+          # run on the subscription.
+          CODEX_OAUTH_ACCESS_TOKEN: ${{ secrets.CODEX_OAUTH_ACCESS_TOKEN }}
          # Layer-1 runtime auth lock (mirrors the guard step): the CLI refuses to
          # run when the tokenEnv the loaded config honors differs from this.
-          ECR_EXPECTED_TOKEN_ENV: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_REFRESH_TOKEN' }}
+          ECR_EXPECTED_TOKEN_ENV: ${{ vars.ECR_EXPECTED_TOKEN_ENV || 'CODEX_OAUTH_ACCESS_TOKEN' }}
          # Optional: override the model used by every agent.
          REVIEWER_MODEL: ${{ vars.REVIEWER_MODEL }}
          AGENTS: ${{ steps.resolve.outputs.agents }}
@@ -6,34 +6,9 @@ on:
 name: Release workflow

 jobs:
-  # A prerelease tag (any version carrying a SemVer prerelease identifier, e.g.
-  # v21.3.0-beta.0) must NOT be treated like a stable release: npm does not
-  # special-case prerelease versions, so publishing one without an explicit dist-tag
-  # would point `latest` at it and hand it to every `npx eas-cli` user. Every job below
-  # branches on this one output instead of re-deriving it from the tag.
-  resolve:
-    name: Resolve release kind
-    runs-on: ubuntu-latest
-    outputs:
-      version: ${{ steps.resolve.outputs.version }}
-      prerelease: ${{ steps.resolve.outputs.prerelease }}
-    steps:
-      - id: resolve
-        run: |
-          VERSION="${GITHUB_REF#refs/tags/v}"
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          # SemVer puts the prerelease identifier after a hyphen: 21.3.0-beta.0.
-          if [[ "$VERSION" == *-* ]]; then
-            echo "prerelease=true" >> "$GITHUB_OUTPUT"
-            echo "::notice::$VERSION is a prerelease: publishing under the 'next' dist-tag, leaving 'latest', the EAS Build tags and CHANGELOG.md untouched."
-          else
-            echo "prerelease=false" >> "$GITHUB_OUTPUT"
-          fi
-
  release:
    name: Create a release
    runs-on: ubuntu-latest
-    needs: resolve
    permissions:
      contents: write
    outputs:
@@ -46,15 +21,11 @@ jobs:
        with:
          tag_name: ${{ github.ref }}
          release_name: ${{ github.ref }}
-          # A stable release stays a draft until the changelog job publishes it with
-          # notes. A prerelease skips that job, so publish it immediately and flag it so
-          # GitHub never presents it as the repo's latest release.
-          draft: ${{ needs.resolve.outputs.prerelease == 'false' }}
-          prerelease: ${{ needs.resolve.outputs.prerelease == 'true' }}
+          draft: true
  publish-to-npm:
    name: Publish to npm
    runs-on: ubuntu-latest
-    needs: [resolve, release]
+    needs: release
    permissions:
      id-token: write
    steps:
@@ -64,18 +35,9 @@ jobs:
        run: yarn install --immutable
      - name: Build
        run: yarn build
-      # Always pass the dist-tag explicitly. `latest` is what npm would have defaulted
-      # to, so stable releases are unchanged — but relying on that default is what made
-      # a prerelease publish unsafe, so the intent is stated rather than inherited.
      - name: Publish packages to npm
-        env:
-          DIST_TAG: ${{ needs.resolve.outputs.prerelease == 'true' && 'next' || 'latest' }}
-        run: yarn run -T lerna publish from-package --yes --no-verify-access --dist-tag "$DIST_TAG"
-      # These two tags select the CLI version used by EAS Build. A prerelease must never
-      # move them (that would put untested code in production builds); `latest-eas-build`
-      # also has its own gated workflow for moving it deliberately.
+        run: yarn run -T lerna publish from-package --yes --no-verify-access
      - name: Add latest-eas-build-staging tag
-        if: needs.resolve.outputs.prerelease == 'false'
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
        run: |
@@ -83,22 +45,16 @@ jobs:
          echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
          npm dist-tag add eas-cli@$VERSION latest-eas-build-staging
      - name: Add latest-eas-build tag
-        if: needs.resolve.outputs.prerelease == 'false'
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_ACCESS_TOKEN }}
        run: |
          VERSION=$(cat lerna.json | jq -r .version)
          echo //registry.npmjs.org/:_authToken=$NODE_AUTH_TOKEN > ~/.npmrc
          npm dist-tag add eas-cli@$VERSION latest-eas-build
-  # Stable releases only. A prerelease must leave CHANGELOG.md alone: its entries stay
-  # under "unreleased" so the eventual stable release still announces them. Skipping this
-  # job also keeps a prerelease from committing to main and from Slack-announcing itself
-  # as a release — the GitHub prerelease is its announcement.
  release-changelog:
    name: Update changelog and publish release
-    if: needs.resolve.outputs.prerelease == 'false'
    runs-on: ubuntu-latest
-    needs: [resolve, publish-to-npm]
+    needs: publish-to-npm
    permissions:
      contents: write
    steps:
@@ -4,7 +4,7 @@ on:
      version:
        type: string
        required: false
-        description: 'Version for the release, e.g. "21.3.0". Prerelease: "21.3.0-beta.0" (publishes under the `next` dist-tag; see RELEASING.md). Leave empty to derive the next stable version from the changelog.'
+        description: 'Version number for the release'
      dry_run:
        type: boolean
        required: true
@@ -8,10 +8,20 @@ This is the log of notable changes to EAS CLI and related packages.

 ### 🎉 New features

+- [eas-cli] Add experimental `eas simulator:events` command. ([#4001](https://github.com/expo/eas-cli/pull/4001) by [@szdziedzic](https://github.com/szdziedzic))
+- [build-tools] Collect and upload Argent tool-server session events during remote simulator sessions, mirroring agent-device event collection. ([#4067](https://github.com/expo/eas-cli/pull/4067) by [@szdziedzic](https://github.com/szdziedzic))
+- [eas-cli] Add `--name` to `eas simulator:start` and show simulator session names in `eas simulator:get` and `eas simulator:list`. ([#4099](https://github.com/expo/eas-cli/pull/4099) by [@szdziedzic](https://github.com/szdziedzic))
+
 ### 🐛 Bug fixes

+- [eas-cli] Apply --session-id in observe:events summary mode. ([#4100](https://github.com/expo/eas-cli/pull/4100) by [@douglowder](https://github.com/douglowder))
+- [eas-cli] Suggest running `agent-device` via `npx` in EAS Simulator session instructions. ([#4070](https://github.com/expo/eas-cli/pull/4070) by [@szdziedzic](https://github.com/szdziedzic))
+
 ### 🧹 Chores

+- [eas-cli] Refresh README as an EAS product landing page. ([#3844](https://github.com/expo/eas-cli/pull/3844) by [@szdziedzic](https://github.com/szdziedzic))
+- [eas-cli] Fix the EAS logo not rendering in the repository root README. ([#4093](https://github.com/expo/eas-cli/pull/4093) by [@szdziedzic](https://github.com/szdziedzic))
+
 ## [21.3.0](https://github.com/expo/eas-cli/releases/tag/v21.3.0) - 2026-07-27

 ### 🎉 New features
@@ -104,6 +114,7 @@ This is the log of notable changes to EAS CLI and related packages.
 - [build-tools] Skip embedded bundle upload for development client builds instead of warning that the bundle is missing. ([#3940](https://github.com/expo/eas-cli/pull/3940) by [@gwdp](https://github.com/gwdp))
 - [eas-cli] Accept a navigation metric name in observe:metrics when passed in on the command line. ([#3973](https://github.com/expo/eas-cli/pull/3973) by [@douglowder](https://github.com/douglowder))
 - [eas-cli] Retry uploading assets that don't finish processing during `eas update`, instead of failing the update. ([#3918](https://github.com/expo/eas-cli/pull/3918) by [@gwdp](https://github.com/gwdp))
+- [eas-cli] Show network and HTTP response details for EAS Build request failures when GraphQL errors are empty. ([#3982](https://github.com/expo/eas-cli/pull/3982) by [@szdziedzic](https://github.com/szdziedzic))

 ### 🧹 Chores

@@ -12,78 +12,3 @@ The algorithm works as follows:
 - If there are any entries in the "🛠 Breaking changes" section, bump the MAJOR version.
 - Otherwise, if there are any entries in the "🎉 New features", bump the MINOR version.
 - Otherwise, bump the PATCH version.
-
-## Prereleases
-
-A prerelease publishes a real version to npm that nobody gets by accident: it goes out
-under the `next` dist-tag, so `latest` keeps pointing at the current stable release and
-`npx eas-cli` is unaffected. Use one to get a risky change in front of users (or to dogfood
-it in a real project) before committing to a stable release.
-
-**Cutting one:** invoke the same ["Manually trigger a release"](https://github.com/expo/eas-cli/actions/workflows/trigger-release.yml)
-workflow, but pass an explicit prerelease version — e.g. `21.3.0-beta.0`. Any version with a
-SemVer prerelease identifier (the part after the hyphen) is treated as a prerelease; the
-identifier itself is free-form, so `-beta.0`, `-rc.1` and `-canary.0` all work. You must pass
-the version explicitly: the changelog-based algorithm above only ever produces stable versions.
-
-**Installing one:**
-
-```sh
-npm i -g eas-cli@next          # whatever the current prerelease is
-npm i -g [email protected] # a specific one
-```
-
-**What a prerelease does differently.** Everything is driven off the pushed tag by
-`.github/workflows/release.yml`, which detects the prerelease identifier and then:
-
-|                                      | Stable            | Prerelease                       |
-| ------------------------------------ | ----------------- | -------------------------------- |
-| npm dist-tag                         | `latest`          | `next`                           |
-| `latest-eas-build` / `-staging` tags | moved             | **left alone**                   |
-| CHANGELOG.md                         | cut and committed | **left alone**                   |
-| GitHub release                       | draft → published | published, flagged as prerelease |
-| Slack announcement in #eas-cli       | yes               | no                               |
-
-The EAS Build tags are deliberately untouched: they select the CLI version used by EAS
-Build, so moving them to a prerelease would put untested code into production builds.
-Move them on purpose with the ["Move NPM tags used by EAS builds and workflows"](https://github.com/expo/eas-cli/actions/workflows/move-eas-build-tag.yml)
-workflow if that is what you actually want.
-
-CHANGELOG.md is also untouched, so a prerelease's entries stay under "unreleased" and are
-announced with the stable release that follows.
-
-### Prereleases in this monorepo
-
-Prereleases version and publish packages exactly like stable releases do — lerna runs in
-fixed mode, so it applies the single version from `lerna.json` to the packages that changed
-since the last release and leaves the rest alone (which is why the packages sit at different
-versions). `lerna publish from-package` then publishes whichever of those aren't on the
-registry yet, and the `next` dist-tag applies to every package published in that run.
-`latest` is untouched for all of them, so nothing that depends on `@expo/eas-json`,
-`@expo/steps`, `@expo/eas-build-job` or friends picks up a prerelease implicitly.
-
-Two consequences worth knowing:
-
- **The version line is shared.** After `21.3.0-beta.0`, the next stable release from main
-  is `21.3.0` — the prerelease consumes that version number for the whole repo. Cutting a
-  `21.2.1` patch afterwards means passing that version explicitly.
- **main carries the prerelease version.** `lerna version` commits the bump, so `lerna.json`
-  and the changed packages sit at `21.3.0-beta.0` until the next release. The changelog-based
-  algorithm still resolves correctly from there (a MINOR or PATCH bump off `21.3.0-beta.0`
-  both land on `21.3.0`).
-
-### Testing an unmerged branch
-
-Prereleases are cut from `main`, so they are not the tool for validating a PR before it
-merges. For that, build the branch locally and run it directly:
-
-```sh
-yarn && yarn build
-./packages/eas-cli/bin/run --version
-```
-
-or pack a tarball to install elsewhere:
-
-```sh
-cd packages/eas-cli && yarn pack   # then: npm i -g ./eas-cli-*.tgz
-```
@@ -1,5 +1,5 @@
 {
  "npmClient": "yarn",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "$schema": "node_modules/lerna/schemas/lerna-schema.json"
 }
@@ -1,6 +1,6 @@
 {
  "name": "@expo/build-tools",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "bugs": "https://github.com/expo/eas-cli/issues",
  "license": "BUSL-1.1",
  "author": "Expo <[email protected]>",
@@ -39,14 +39,14 @@
    "@expo/config": "55.0.10",
    "@expo/config-plugins": "55.0.7",
    "@expo/downloader": "21.0.0",
-    "@expo/eas-build-job": "21.3.0",
+    "@expo/eas-build-job": "21.4.0",
    "@expo/env": "^0.4.0",
    "@expo/logger": "21.0.0",
    "@expo/package-manager": "1.9.10",
    "@expo/plist": "^0.3.5",
    "@expo/results": "^1.0.0",
    "@expo/spawn-async": "1.7.2",
-    "@expo/steps": "21.3.0",
+    "@expo/steps": "21.4.0",
    "@expo/template-file": "21.0.2",
    "@expo/turtle-spawn": "21.0.0",
    "@expo/xcpretty": "^4.3.1",
@@ -0,0 +1,138 @@
+import { BuildRuntimePlatform, type BuildStepContext } from '@expo/steps';
+import spawn from '@expo/turtle-spawn';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { type CustomBuildContext } from '../../../customBuildContext';
+import { isProcessDescendantOfAsync } from '../../../utils/processes';
+import { pollArgentArtifactsForUploadAsync } from '../../utils/argentArtifacts';
+import { startArgentEventCollectionAsync } from '../../utils/argentEvents';
+import {
+  getDeviceRunSessionIdOrThrow,
+  getNgrokAuthtokenOrThrow,
+  getNgrokTunnelDomainOrThrow,
+  selectXcodeDeveloperDirectoryAsync,
+  spawnDetached,
+  startNgrokTunnelAsync,
+  uploadRemoteSessionConfigAsync,
+  waitForDeviceRunSessionStoppedAsync,
+} from '../../utils/remoteDeviceRunSession';
+import { createStartArgentRemoteSessionBuildFunction } from '../startArgentRemoteSession';
+
+// Redirect ~/.argent (where the tool-server writes its state file and event log) to a temp
+// home so waitForArgentToolServerStateAsync — which lives in the module under test and cannot
+// be mocked directly — can read a real state file we control.
+jest.mock('node:os', () => {
+  const actual = jest.requireActual('node:os');
+  const actualPath = jest.requireActual('node:path');
+  return {
+    ...actual,
+    homedir: () => actualPath.join(actual.tmpdir(), 'eas-argent-orchestration-home'),
+  };
+});
+jest.mock('@expo/turtle-spawn', () => ({ __esModule: true, default: jest.fn() }));
+jest.mock('../../../sentry');
+jest.mock('../../../utils/processes', () => ({ isProcessDescendantOfAsync: jest.fn() }));
+jest.mock('../../utils/argentArtifacts', () => ({ pollArgentArtifactsForUploadAsync: jest.fn() }));
+jest.mock('../../utils/argentEvents', () => ({
+  ...jest.requireActual('../../utils/argentEvents'),
+  startArgentEventCollectionAsync: jest.fn(),
+}));
+jest.mock('../../utils/remoteDeviceRunSession', () => ({
+  getDeviceRunSessionIdOrThrow: jest.fn(),
+  getNgrokAuthtokenOrThrow: jest.fn(),
+  getNgrokTunnelDomainOrThrow: jest.fn(),
+  selectXcodeDeveloperDirectoryAsync: jest.fn(),
+  spawnDetached: jest.fn(),
+  startNgrokTunnelAsync: jest.fn(),
+  startServeSimWithTunnelAsync: jest.fn(),
+  uploadRemoteSessionConfigAsync: jest.fn(),
+  waitForDeviceRunSessionStoppedAsync: jest.fn(),
+}));
+
+const TEST_HOME = path.join(os.tmpdir(), 'eas-argent-orchestration-home');
+const ARGENT_STATE_DIR = path.join(TEST_HOME, '.argent');
+const EXPECTED_EVENT_LOG_PATH = path.join(ARGENT_STATE_DIR, 'tool-server-events.jsonl');
+
+const mockStopAsync = jest.fn();
+
+describe('createStartArgentRemoteSessionBuildFunction orchestration', () => {
+  beforeEach(async () => {
+    jest.clearAllMocks();
+
+    jest.mocked(spawn).mockResolvedValue(undefined as never);
+    jest.mocked(isProcessDescendantOfAsync).mockResolvedValue(true);
+    jest.mocked(pollArgentArtifactsForUploadAsync).mockResolvedValue(undefined);
+    mockStopAsync.mockResolvedValue(undefined);
+    jest.mocked(startArgentEventCollectionAsync).mockResolvedValue({ stopAsync: mockStopAsync });
+
+    jest.mocked(getDeviceRunSessionIdOrThrow).mockReturnValue('device-run-session-id');
+    jest.mocked(getNgrokTunnelDomainOrThrow).mockReturnValue('tunnel.example.com');
+    jest.mocked(getNgrokAuthtokenOrThrow).mockReturnValue('ngrok-token');
+    jest.mocked(selectXcodeDeveloperDirectoryAsync).mockResolvedValue(undefined);
+    jest.mocked(spawnDetached).mockReturnValue({ pid: 4242, getOutput: () => '' });
+    jest.mocked(startNgrokTunnelAsync).mockResolvedValue('https://argent-abc.tunnel.example.com');
+    jest.mocked(uploadRemoteSessionConfigAsync).mockResolvedValue(undefined);
+    jest.mocked(waitForDeviceRunSessionStoppedAsync).mockResolvedValue(undefined);
+
+    // The (real) tool-server state wait reads this file from the redirected ~/.argent.
+    await fs.promises.mkdir(ARGENT_STATE_DIR, { recursive: true });
+    await fs.promises.writeFile(
+      path.join(ARGENT_STATE_DIR, 'tool-server-orchestration.json'),
+      JSON.stringify({ port: 5678, pid: 9999, token: 'tool-server-token' })
+    );
+  });
+
+  afterEach(async () => {
+    await fs.promises.rm(TEST_HOME, { recursive: true, force: true });
+  });
+
+  it('enables the event log flag, shares one path, and starts/stops the collector', async () => {
+    const ctx = {} as unknown as CustomBuildContext;
+    const buildFunction = createStartArgentRemoteSessionBuildFunction(ctx);
+
+    await buildFunction.fn!(
+      {
+        logger: { info: jest.fn(), warn: jest.fn() },
+        global: { runtimePlatform: BuildRuntimePlatform.LINUX },
+      } as unknown as BuildStepContext,
+      {
+        inputs: { package_version: { value: undefined } },
+        outputs: {},
+        env: { EXISTING: 'value' },
+      } as never
+    );
+
+    // (1) The event log flag is enabled, before the tool-server is launched.
+    const spawnCalls = jest.mocked(spawn).mock.calls;
+    const enableEventLogIndex = spawnCalls.findIndex(
+      ([command, args]) =>
+        command === 'bunx' && Array.isArray(args) && args.includes('tool-server-event-log')
+    );
+    expect(enableEventLogIndex).toBeGreaterThanOrEqual(0);
+    expect(jest.mocked(spawn).mock.invocationCallOrder[enableEventLogIndex]).toBeLessThan(
+      jest.mocked(spawnDetached).mock.invocationCallOrder[0]
+    );
+
+    // (2) The tool-server and the collector are pinned to the exact same event log path.
+    const serverEnv = jest.mocked(spawnDetached).mock.calls[0][0].env;
+    expect(serverEnv.ARGENT_EVENT_LOG).toBe(EXPECTED_EVENT_LOG_PATH);
+    expect(serverEnv.EXISTING).toBe('value');
+    expect(jest.mocked(startArgentEventCollectionAsync).mock.calls[0][0]).toMatchObject({
+      deviceRunSessionId: 'device-run-session-id',
+      eventLogPath: EXPECTED_EVENT_LOG_PATH,
+    });
+
+    // (3) Collection starts (before we wait for the session to stop) and (4) is torn down
+    // afterwards, exactly once.
+    expect(startArgentEventCollectionAsync).toHaveBeenCalledTimes(1);
+    expect(mockStopAsync).toHaveBeenCalledTimes(1);
+    expect(jest.mocked(startArgentEventCollectionAsync).mock.invocationCallOrder[0]).toBeLessThan(
+      jest.mocked(waitForDeviceRunSessionStoppedAsync).mock.invocationCallOrder[0]
+    );
+    expect(mockStopAsync.mock.invocationCallOrder[0]).toBeGreaterThan(
+      jest.mocked(waitForDeviceRunSessionStoppedAsync).mock.invocationCallOrder[0]
+    );
+  });
+});
@@ -4,12 +4,16 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';

+import { Sentry } from '../../../sentry';
 import {
  MIN_ARGENT_REMOTE_SESSION_VERSION,
+  stopArgentEventCollectionSafelyAsync,
  waitForArgentToolServerStateAsync,
  warnIfArgentPackageVersionCannotBeVerified,
 } from '../startArgentRemoteSession';

+jest.mock('../../../sentry');
+
 describe(warnIfArgentPackageVersionCannotBeVerified, () => {
  const warn = jest.fn();
  const logger = { warn } as unknown as bunyan;
@@ -143,3 +147,36 @@ describe(waitForArgentToolServerStateAsync, () => {
    ).rejects.toThrow(`state file belonging to process ${process.pid}`);
  });
 });
+
+describe(stopArgentEventCollectionSafelyAsync, () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('reports an unexpected stop failure without rejecting', async () => {
+    const error = new Error('stop failed');
+    const logger = { warn: jest.fn() } as unknown as bunyan;
+
+    await expect(
+      stopArgentEventCollectionSafelyAsync({
+        eventCollection: { stopAsync: jest.fn().mockRejectedValue(error) },
+        deviceRunSessionId: 'session-id',
+        logger,
+      })
+    ).resolves.toBeUndefined();
+
+    expect(Sentry.capture).toHaveBeenCalledWith(
+      'Could not finish argent session event collection',
+      error,
+      {
+        level: 'warning',
+        tags: { phase: 'argent-event-collection', operation: 'stop' },
+        extras: { deviceRunSessionId: 'session-id' },
+      }
+    );
+    expect(logger.warn).toHaveBeenCalledWith(
+      { err: error },
+      'Could not finish argent session event collection.'
+    );
+  });
+});
@@ -15,7 +15,7 @@ import path from 'node:path';
 import { type CustomBuildContext } from '../../customBuildContext';
 import { Sentry } from '../../sentry';
 import { pollAgentDeviceArtifactsForUploadAsync } from '../utils/agentDeviceArtifacts';
-import { startAgentDeviceEventCollectionAsync } from '../utils/deviceRunSessionEvents';
+import { startAgentDeviceEventCollectionAsync } from '../utils/agentDeviceEvents';
 import {
  type DetachedProcessHandle,
  getDeviceRunSessionIdOrThrow,
@@ -18,6 +18,7 @@ import { Sentry } from '../../sentry';
 import { isProcessDescendantOfAsync } from '../../utils/processes';
 import { sleepAsync } from '../../utils/retry';
 import { pollArgentArtifactsForUploadAsync } from '../utils/argentArtifacts';
+import { ARGENT_EVENT_LOG_FILENAME, startArgentEventCollectionAsync } from '../utils/argentEvents';
 import {
  getDeviceRunSessionIdOrThrow,
  getNgrokAuthtokenOrThrow,
@@ -31,9 +32,17 @@ import {
 } from '../utils/remoteDeviceRunSession';

 const ARGENT_PACKAGE_NAME = '@swmansion/argent';
-export const MIN_ARGENT_REMOTE_SESSION_VERSION = '0.12.0';
+// 0.16.0 is the first version that exposes the tool-server event log flag; keeping the floor
+// here lets us enable it (and the artifacts list endpoint) unconditionally below.
+export const MIN_ARGENT_REMOTE_SESSION_VERSION = '0.16.0';
 const ARGENT_ARTIFACTS_LIST_ENDPOINT_FLAG = 'artifacts-list-endpoint';
+// Tells the tool-server to write its structured event log so we can collect session events.
+const ARGENT_EVENT_LOG_FLAG = 'tool-server-event-log';
 const ARGENT_STATE_DIR = path.join(os.homedir(), '.argent');
+// Pin the event log path explicitly and hand the same value to the tool-server (via
+// ARGENT_EVENT_LOG) and the collector, so an ambient ARGENT_EVENT_LOG or a future change to
+// Argent's default can never make the two disagree.
+const ARGENT_EVENT_LOG_PATH = path.join(ARGENT_STATE_DIR, ARGENT_EVENT_LOG_FILENAME);
 const STARTUP_TIMEOUT_MS = 60_000;

 const ArgentToolServerStateSchema = z.object({
@@ -87,6 +96,13 @@ export function createStartArgentRemoteSessionBuildFunction(
        { env, logger }
      );

+      logger.info('Enabling the Argent tool-server event log flag.');
+      await spawn(
+        'bunx',
+        [`${ARGENT_PACKAGE_NAME}@${versionSpec}`, 'enable', ARGENT_EVENT_LOG_FLAG],
+        { env, logger }
+      );
+
      logger.info(`Launching ${ARGENT_PACKAGE_NAME}@${versionSpec} tool-server via bunx.`);
      // Keep Argent itself in foreground mode under the detached bunx process. This preserves
      // the bunx -> Argent CLI -> tool-server ancestry used to identify the matching state file.
@@ -102,7 +118,7 @@ export function createStartArgentRemoteSessionBuildFunction(
          '0',
          '--force',
        ],
-        env,
+        env: { ...env, ARGENT_EVENT_LOG: ARGENT_EVENT_LOG_PATH },
      });
      if (argentServer.pid === undefined) {
        throw new SystemError(
@@ -142,6 +158,13 @@ export function createStartArgentRemoteSessionBuildFunction(
        signal: artifactPollSignal,
      });

+      const eventCollection = await startArgentEventCollectionAsync({
+        ctx,
+        deviceRunSessionId,
+        eventLogPath: ARGENT_EVENT_LOG_PATH,
+        logger,
+      });
+
      try {
        const publicToolsUrl = await startNgrokTunnelAsync({
          port: toolServerPort,
@@ -184,6 +207,7 @@ export function createStartArgentRemoteSessionBuildFunction(
          signal,
        });
      } finally {
+        await stopArgentEventCollectionSafelyAsync({ eventCollection, deviceRunSessionId, logger });
        artifactPollAbortController.abort();
        try {
          await artifactPollingPromise;
@@ -197,6 +221,28 @@ export function createStartArgentRemoteSessionBuildFunction(
  });
 }

+export async function stopArgentEventCollectionSafelyAsync({
+  eventCollection,
+  deviceRunSessionId,
+  logger,
+}: {
+  eventCollection: { stopAsync: () => Promise<void> };
+  deviceRunSessionId: string;
+  logger: bunyan;
+}): Promise<void> {
+  try {
+    await eventCollection.stopAsync();
+  } catch (err) {
+    const error = err instanceof Error ? err : new Error(String(err));
+    Sentry.capture('Could not finish argent session event collection', error, {
+      level: 'warning',
+      tags: { phase: 'argent-event-collection', operation: 'stop' },
+      extras: { deviceRunSessionId },
+    });
+    logger.warn({ err: error }, 'Could not finish argent session event collection.');
+  }
+}
+
 export function warnIfArgentPackageVersionCannotBeVerified({
  packageVersion,
  logger,
@@ -6,7 +6,7 @@ import path from 'node:path';
 import { type CustomBuildContext } from '../../../customBuildContext';
 import RemoteLoggerStream from '../../../logging/RemoteLoggerStream';
 import { Sentry } from '../../../sentry';
-import { startAgentDeviceEventCollectionAsync } from '../deviceRunSessionEvents';
+import { startAgentDeviceEventCollectionAsync } from '../agentDeviceEvents';

 const mockEventLogStream = {
  init: jest.fn(async () => undefined),
@@ -370,7 +370,8 @@ describe(startAgentDeviceEventCollectionAsync, () => {

    expect(logger.warn).toHaveBeenCalledWith(
      {
-        agentDeviceEventParseFailures: { 'invalid-json': 1, 'invalid-event': 1 },
+        producer: 'agent-device',
+        eventParseFailures: { 'invalid-json': 1, 'invalid-event': 1 },
        parseFailureCount: 2,
      },
      'Could not parse 2 agent-device event log records.'
@@ -446,7 +447,7 @@ describe(startAgentDeviceEventCollectionAsync, () => {
      await waitForAsync(() =>
        expect(logger.warn).toHaveBeenCalledWith(
          { err: reportingError },
-          'Agent-device event collection poller failed.'
+          'Event collection poller for agent-device failed.'
        )
      );
      await expect(collection.stopAsync()).resolves.toBeUndefined();
@@ -457,7 +458,7 @@ describe(startAgentDeviceEventCollectionAsync, () => {
    expect(Sentry.capture).toHaveBeenCalledTimes(2);
    expect(Sentry.capture).toHaveBeenNthCalledWith(
      2,
-      'Agent-device event collection poller failed',
+      'Event collection poller for agent-device failed',
      reportingError,
      {
        level: 'warning',
@@ -502,7 +503,11 @@ describe(startAgentDeviceEventCollectionAsync, () => {
      }),
      {
        level: 'warning',
-        tags: { phase: 'device-run-session-event-collection', operation: 'setup' },
+        tags: {
+          phase: 'device-run-session-event-collection',
+          operation: 'setup',
+          producer: 'agent-device',
+        },
        extras: { deviceRunSessionId: 'session-id' },
      }
    );
@@ -0,0 +1,324 @@
+import { type bunyan } from '@expo/logger';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+import { type CustomBuildContext } from '../../../customBuildContext';
+import RemoteLoggerStream from '../../../logging/RemoteLoggerStream';
+import { Sentry } from '../../../sentry';
+import { startArgentEventCollectionAsync } from '../argentEvents';
+
+const mockEventLogStream = {
+  init: jest.fn(async () => undefined),
+  write: jest.fn(),
+  cleanUp: jest.fn(async () => undefined),
+};
+
+jest.mock('../../../logging/RemoteLoggerStream', () => ({
+  __esModule: true,
+  default: jest.fn(() => mockEventLogStream),
+}));
+jest.mock('../../../sentry');
+
+const EVENT_LOG_FILENAME = 'tool-server-events.jsonl';
+
+describe(startArgentEventCollectionAsync, () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('maps tool lifecycle records onto the shared operation vocabulary', async () => {
+    const stateDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'argent-events-'));
+    const eventLogFile = path.join(stateDir, EVENT_LOG_FILENAME);
+    await fs.promises.writeFile(
+      eventLogFile,
+      `${JSON.stringify(
+        bunyanRecord({
+          level: 30,
+          type: 'tool.invoked',
+          toolId: 'screenshot',
+          toolInvocationId: 'call-1',
+          msg: 'Capturing screenshot.',
+          time: '2026-07-10T12:00:00.000Z',
+        })
+      )}\n`
+    );
+    const ctx = createContext();
+    const logger = createLogger();
+    const collection = await startArgentEventCollectionAsync({
+      ctx,
+      deviceRunSessionId: 'session-id',
+      eventLogPath: eventLogFile,
+      logger,
+      pollIntervalMs: 10,
+    });
+
+    try {
+      await waitForAsync(() => expect(mockEventLogStream.write).toHaveBeenCalledTimes(1));
+      await fs.promises.appendFile(
+        eventLogFile,
+        `${JSON.stringify(
+          bunyanRecord({
+            level: 30,
+            type: 'tool.completed',
+            toolId: 'screenshot',
+            toolInvocationId: 'call-1',
+            durationMs: 12.34,
+            msg: 'Captured screenshot.',
+            time: '2026-07-10T12:00:01.000Z',
+          })
+        )}\n`
+      );
+      await waitForAsync(() => expect(mockEventLogStream.write).toHaveBeenCalledTimes(2));
+    } finally {
+      await collection.stopAsync();
+      await fs.promises.rm(stateDir, { recursive: true, force: true });
+    }
+
+    expect(ctx.graphqlClient.mutation).toHaveBeenCalledWith(expect.anything(), {
+      deviceRunSessionId: 'session-id',
+    });
+    expect(RemoteLoggerStream).toHaveBeenCalledWith({
+      logger,
+      uploadMethod: {
+        signedUrl: {
+          url: 'https://uploads.expo.test/events',
+          headers: { 'content-disposition': 'attachment; filename="events.ndjson"' },
+        },
+      },
+      options: { uploadIntervalMs: 5_000 },
+    });
+    expect(mockEventLogStream.init).toHaveBeenCalledTimes(1);
+    expect(mockEventLogStream.cleanUp).toHaveBeenCalledTimes(1);
+    expect(mockEventLogStream.write).toHaveBeenNthCalledWith(1, {
+      v: 1,
+      eventId: 'argent:session-id:tool-server-events:1',
+      ts: '2026-07-10T12:00:00.000Z',
+      producer: 'argent',
+      type: 'operation.started',
+      operationId: 'call-1',
+      summary: 'Capturing screenshot.',
+      data: { toolId: 'screenshot', sourceType: 'tool.invoked', sourceLevel: 30 },
+    });
+    expect(mockEventLogStream.write).toHaveBeenNthCalledWith(2, {
+      v: 1,
+      eventId: 'argent:session-id:tool-server-events:2',
+      ts: '2026-07-10T12:00:01.000Z',
+      producer: 'argent',
+      type: 'operation.completed',
+      operationId: 'call-1',
+      outcome: 'success',
+      durationMs: 12.34,
+      summary: 'Captured screenshot.',
+      data: { toolId: 'screenshot', sourceType: 'tool.completed', sourceLevel: 30 },
+    });
+    expect(Sentry.capture).not.toHaveBeenCalled();
+  });
+
+  it('marks failed tool records as failed operations and keeps their failure signal', async () => {
+    const failureSignal = {
+      error_code: 'REGISTRY_TOOL_FAILURE_UNCLASSIFIED',
+      failure_stage: 'registry_tool_failed_event',
+      failure_area: 'registry',
+      error_kind: 'unknown',
+    };
+    const event = await collectSingleEventAsync(
+      bunyanRecord({
+        level: 50,
+        type: 'tool.failed',
+        toolId: 'screenshot',
+        toolInvocationId: 'call-2',
+        failureSignal,
+        msg: 'Failed to capture screenshot.',
+        time: '2026-07-10T12:00:02.000Z',
+      })
+    );
+
+    expect(event).toEqual({
+      v: 1,
+      eventId: 'argent:session-id:tool-server-events:1',
+      ts: '2026-07-10T12:00:02.000Z',
+      producer: 'argent',
+      type: 'operation.completed',
+      operationId: 'call-2',
+      outcome: 'failure',
+      summary: 'Failed to capture screenshot.',
+      data: {
+        toolId: 'screenshot',
+        failureSignal,
+        sourceType: 'tool.failed',
+        sourceLevel: 50,
+      },
+    });
+  });
+
+  it('passes through non-tool lifecycle records unchanged', async () => {
+    const event = await collectSingleEventAsync(
+      bunyanRecord({
+        level: 30,
+        type: 'service.state_change',
+        serviceId: 'ax-service',
+        from: 'stopped',
+        to: 'running',
+        msg: 'Service ax-service changed state from stopped to running.',
+        time: '2026-07-10T12:00:03.000Z',
+      })
+    );
+
+    expect(event).toEqual({
+      v: 1,
+      eventId: 'argent:session-id:tool-server-events:1',
+      ts: '2026-07-10T12:00:03.000Z',
+      producer: 'argent',
+      type: 'service.state_change',
+      summary: 'Service ax-service changed state from stopped to running.',
+      data: {
+        serviceId: 'ax-service',
+        from: 'stopped',
+        to: 'running',
+        sourceType: 'service.state_change',
+        sourceLevel: 30,
+      },
+    });
+  });
+
+  // `type` and `msg` are both required by Argent's EventLogRecord, so a record missing either
+  // is a broken upstream contract worth reporting — not something to paper over with an
+  // invented summary.
+  it.each([
+    ['type', { time: '2026-07-10T12:00:00.000Z', msg: 'No type.' }],
+    ['msg', { time: '2026-07-10T12:00:00.000Z', type: 'tool.invoked', toolId: 'tap' }],
+  ])('reports a record missing %s without emitting an event', async (_field, record) => {
+    const stateDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'argent-events-'));
+    const eventLogPath = path.join(stateDir, EVENT_LOG_FILENAME);
+    await fs.promises.writeFile(eventLogPath, `${JSON.stringify(bunyanRecord(record))}\n`);
+    const collection = await startArgentEventCollectionAsync({
+      ctx: createContext(),
+      deviceRunSessionId: 'session-id',
+      eventLogPath,
+      logger: createLogger(),
+      pollIntervalMs: 10,
+    });
+
+    try {
+      await waitForAsync(() => expect(Sentry.capture).toHaveBeenCalledTimes(1));
+    } finally {
+      await collection.stopAsync();
+      await fs.promises.rm(stateDir, { recursive: true, force: true });
+    }
+
+    expect(mockEventLogStream.write).not.toHaveBeenCalled();
+    expect(Sentry.capture).toHaveBeenCalledWith('Could not parse an argent event log record', {
+      level: 'warning',
+      tags: { phase: 'argent-event-collection', reason: 'invalid-event' },
+      extras: { deviceRunSessionId: 'session-id', lineNumber: 1 },
+    });
+  });
+
+  it('surfaces a non-ENOENT discovery error instead of treating it as no events', async () => {
+    // A regular file standing in for the state directory makes access() fail with ENOTDIR
+    // (not ENOENT), which must propagate to the collector's Sentry reporting.
+    const notADirectory = path.join(
+      await fs.promises.mkdtemp(path.join(os.tmpdir(), 'argent-events-')),
+      'regular-file'
+    );
+    await fs.promises.writeFile(notADirectory, '');
+    const eventLogPath = path.join(notADirectory, EVENT_LOG_FILENAME);
+    const collection = await startArgentEventCollectionAsync({
+      ctx: createContext(),
+      deviceRunSessionId: 'session-id',
+      eventLogPath,
+      logger: createLogger(),
+      pollIntervalMs: 10,
+    });
+
+    try {
+      await waitForAsync(() => expect(Sentry.capture).toHaveBeenCalledTimes(1));
+    } finally {
+      await collection.stopAsync();
+      await fs.promises.rm(notADirectory, { force: true });
+    }
+
+    expect(mockEventLogStream.write).not.toHaveBeenCalled();
+    expect(Sentry.capture).toHaveBeenCalledWith(
+      'Could not collect argent events',
+      expect.objectContaining({ code: 'ENOTDIR' }),
+      {
+        level: 'warning',
+        tags: { phase: 'argent-event-collection' },
+        extras: { deviceRunSessionId: 'session-id' },
+      }
+    );
+  });
+});
+
+async function collectSingleEventAsync(
+  record: Record<string, unknown>
+): Promise<Record<string, unknown>> {
+  const stateDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'argent-events-'));
+  const eventLogPath = path.join(stateDir, EVENT_LOG_FILENAME);
+  await fs.promises.writeFile(eventLogPath, `${JSON.stringify(record)}\n`);
+  const collection = await startArgentEventCollectionAsync({
+    ctx: createContext(),
+    deviceRunSessionId: 'session-id',
+    eventLogPath,
+    logger: createLogger(),
+    pollIntervalMs: 10,
+  });
+
+  try {
+    await waitForAsync(() => expect(mockEventLogStream.write).toHaveBeenCalledTimes(1));
+  } finally {
+    await collection.stopAsync();
+    await fs.promises.rm(stateDir, { recursive: true, force: true });
+  }
+
+  return mockEventLogStream.write.mock.calls[0][0];
+}
+
+function bunyanRecord(fields: Record<string, unknown>): Record<string, unknown> {
+  return {
+    name: 'argent-tool-server',
+    hostname: 'test-host',
+    pid: 4242,
+    v: 0,
+    ...fields,
+  };
+}
+
+function createContext(): CustomBuildContext {
+  const mutation = jest.fn().mockReturnValue({
+    toPromise: async () => ({
+      data: {
+        deviceRunSession: {
+          createEventLogUploadSession: {
+            uploadSession: {
+              url: 'https://uploads.expo.test/events',
+              headers: { 'content-disposition': 'attachment; filename="events.ndjson"' },
+            },
+          },
+        },
+      },
+    }),
+  });
+  return { graphqlClient: { mutation } } as unknown as CustomBuildContext;
+}
+
+function createLogger(): bunyan {
+  return { info: jest.fn(), warn: jest.fn() } as unknown as bunyan;
+}
+
+async function waitForAsync(assertion: () => void): Promise<void> {
+  const deadline = Date.now() + 2_000;
+  for (;;) {
+    try {
+      assertion();
+      return;
+    } catch (err) {
+      if (Date.now() >= deadline) {
+        throw err;
+      }
+      await new Promise(resolve => setTimeout(resolve, 10));
+    }
+  }
+}
@@ -0,0 +1,155 @@
+import { type bunyan } from '@expo/logger';
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+
+import { type CustomBuildContext } from '../../customBuildContext';
+import {
+  type DeviceRunSessionEvent,
+  type DeviceRunSessionEventParseFailure,
+  startDeviceRunSessionEventCollectionAsync,
+} from './deviceRunSessionEvents';
+
+const AGENT_DEVICE_PRODUCER = 'agent-device';
+
+const AGENT_DEVICE_EVENT_KIND_TO_TYPE: Record<string, string> = {
+  'request.started': 'operation.started',
+  'request.finished': 'operation.completed',
+  'action.recorded': 'interaction.recorded',
+};
+
+const AgentDeviceEventSchema = z
+  .object({
+    version: z.number(),
+    ts: z.string(),
+    session: z.string(),
+    kind: z.string(),
+    requestId: z.string().optional().catch(undefined),
+    command: z.string().optional().catch(undefined),
+    status: z.string().optional().catch(undefined),
+    summary: z.string().optional().catch(undefined),
+    details: z.record(z.string(), z.unknown()).optional().catch(undefined),
+  })
+  .passthrough();
+
+type AgentDeviceEvent = z.infer<typeof AgentDeviceEventSchema>;
+
+export async function startAgentDeviceEventCollectionAsync({
+  ctx,
+  deviceRunSessionId,
+  stateDir,
+  logger,
+  pollIntervalMs,
+}: {
+  ctx: CustomBuildContext;
+  deviceRunSessionId: string;
+  stateDir: string;
+  logger: bunyan;
+  pollIntervalMs?: number;
+}): Promise<{ stopAsync: () => Promise<void> }> {
+  return startDeviceRunSessionEventCollectionAsync({
+    ctx,
+    deviceRunSessionId,
+    logger,
+    pollIntervalMs,
+    source: {
+      producer: AGENT_DEVICE_PRODUCER,
+      findEventFilesAsync: () => findAgentDeviceEventFilesAsync(stateDir),
+      sourceKeyForFile: eventFile => path.basename(path.dirname(eventFile)),
+      parseLine: ({ line, sourceKey, sequenceNumber, deviceRunSessionId }) => {
+        const { event, failure } = parseAgentDeviceEvent(line);
+        if (!event) {
+          return { failure };
+        }
+        return {
+          event: normalizeAgentDeviceEvent({
+            event,
+            sequenceNumber,
+            sourceSessionDirectory: sourceKey,
+            deviceRunSessionId,
+          }),
+        };
+      },
+    },
+  });
+}
+
+async function findAgentDeviceEventFilesAsync(stateDir: string): Promise<string[]> {
+  const sessionsDir = path.join(stateDir, 'sessions');
+  let entries: fs.Dirent[];
+  try {
+    entries = await fs.promises.readdir(sessionsDir, { withFileTypes: true });
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
+      return [];
+    }
+    throw err;
+  }
+
+  return entries
+    .filter(entry => entry.isDirectory())
+    .map(entry => path.join(sessionsDir, entry.name, 'events.ndjson'));
+}
+
+type ParsedAgentDeviceEvent = {
+  event?: AgentDeviceEvent;
+  failure?: DeviceRunSessionEventParseFailure;
+};
+
+function parseAgentDeviceEvent(line: string): ParsedAgentDeviceEvent {
+  if (!line.trim()) {
+    return {};
+  }
+  try {
+    const result = AgentDeviceEventSchema.safeParse(JSON.parse(line));
+    return result.success ? { event: result.data } : { failure: 'invalid-event' };
+  } catch {
+    return { failure: 'invalid-json' };
+  }
+}
+
+function normalizeAgentDeviceEvent({
+  event,
+  sequenceNumber,
+  sourceSessionDirectory,
+  deviceRunSessionId,
+}: {
+  event: AgentDeviceEvent;
+  sequenceNumber: number;
+  sourceSessionDirectory: string;
+  deviceRunSessionId: string;
+}): DeviceRunSessionEvent {
+  const type = AGENT_DEVICE_EVENT_KIND_TO_TYPE[event.kind] ?? event.kind;
+  const durationMs = event.details?.durationMs;
+  const outcome =
+    event.status === 'ok' ? 'success' : event.status === 'error' ? 'failure' : undefined;
+  const summary =
+    event.summary ??
+    (event.kind === 'request.started'
+      ? `Started ${event.command ?? 'activity'}`
+      : event.kind === 'request.finished'
+        ? `Finished ${event.command ?? 'activity'}`
+        : event.kind === 'action.recorded'
+          ? `Recorded ${event.command ?? 'activity'}`
+          : `${event.kind}${event.command ? `: ${event.command}` : ''}`);
+
+  return {
+    v: 1,
+    // Consumers use eventId to deduplicate events across polls. Keep the per-file sequence
+    // monotonic across source-file truncations so an ID is never reused during collection.
+    eventId: `agent-device:${deviceRunSessionId}:${sourceSessionDirectory}:${sequenceNumber}`,
+    ts: event.ts,
+    producer: 'agent-device',
+    type,
+    ...(event.requestId ? { operationId: event.requestId } : {}),
+    ...(outcome ? { outcome } : {}),
+    ...(typeof durationMs === 'number' ? { durationMs } : {}),
+    summary,
+    data: {
+      ...event.details,
+      session: event.session,
+      sourceVersion: event.version,
+      ...(event.status ? { sourceStatus: event.status } : {}),
+    },
+  };
+}
@@ -0,0 +1,170 @@
+import { type bunyan } from '@expo/logger';
+import fs from 'node:fs';
+import path from 'node:path';
+import { z } from 'zod';
+
+import { type CustomBuildContext } from '../../customBuildContext';
+import {
+  type DeviceRunSessionEvent,
+  type DeviceRunSessionEventParseFailure,
+  startDeviceRunSessionEventCollectionAsync,
+} from './deviceRunSessionEvents';
+
+const ARGENT_PRODUCER = 'argent';
+// Argent's tool-server writes its event log to `~/.argent/tool-server-events.jsonl`
+// (its default $ARGENT_EVENT_LOG path) once the `tool-server-event-log` flag is on.
+export const ARGENT_EVENT_LOG_FILENAME = 'tool-server-events.jsonl';
+
+// Argent records are bunyan log lines tagged with a `type`. Map the tool-lifecycle
+// types onto the shared operation vocabulary; anything else (service.*,
+// tool_server.*, future types) passes through unchanged, mirroring agent-device.
+const ARGENT_EVENT_TYPE_TO_TYPE: Record<string, string> = {
+  'tool.invoked': 'operation.started',
+  'tool.completed': 'operation.completed',
+  'tool.failed': 'operation.completed',
+};
+
+// Bunyan bookkeeping plus the fields we promote to the top level of a
+// DeviceRunSessionEvent — excluded from the free-form `data` bag so it carries
+// only the record's own context (toolId, serviceId, failureSignal, ...).
+const NON_DATA_KEYS = new Set([
+  'name',
+  'hostname',
+  'pid',
+  'v',
+  'time',
+  'msg',
+  'level',
+  'type',
+  'toolInvocationId',
+  'durationMs',
+]);
+
+const ArgentEventSchema = z
+  .object({
+    time: z.string(),
+    type: z.string(),
+    // Argent's EventLogRecord requires `msg` and every emit site sets it to the
+    // human-readable description of the event, so it is our summary verbatim.
+    msg: z.string(),
+    level: z.number().optional().catch(undefined),
+    toolId: z.string().optional().catch(undefined),
+    toolInvocationId: z.string().optional().catch(undefined),
+    durationMs: z.number().optional().catch(undefined),
+  })
+  .passthrough();
+
+type ArgentEvent = z.infer<typeof ArgentEventSchema>;
+
+type ParsedArgentEvent = {
+  event?: ArgentEvent;
+  failure?: DeviceRunSessionEventParseFailure;
+};
+
+export async function startArgentEventCollectionAsync({
+  ctx,
+  deviceRunSessionId,
+  eventLogPath,
+  logger,
+  pollIntervalMs,
+}: {
+  ctx: CustomBuildContext;
+  deviceRunSessionId: string;
+  // Absolute path Argent's tool-server writes its event log to (its `ARGENT_EVENT_LOG`).
+  // The caller pins this on both sides so the collector and the tool-server never disagree.
+  eventLogPath: string;
+  logger: bunyan;
+  pollIntervalMs?: number;
+}): Promise<{ stopAsync: () => Promise<void> }> {
+  return startDeviceRunSessionEventCollectionAsync({
+    ctx,
+    deviceRunSessionId,
+    logger,
+    pollIntervalMs,
+    source: {
+      producer: ARGENT_PRODUCER,
+      findEventFilesAsync: () => findArgentEventFilesAsync(eventLogPath),
+      sourceKeyForFile: eventFile => path.basename(eventFile, path.extname(eventFile)),
+      parseLine: ({ line, sourceKey, sequenceNumber, deviceRunSessionId }) => {
+        const { event, failure } = parseArgentEvent(line);
+        if (!event) {
+          return { failure };
+        }
+        return {
+          event: normalizeArgentEvent({ event, sequenceNumber, sourceKey, deviceRunSessionId }),
+        };
+      },
+    },
+  });
+}
+
+async function findArgentEventFilesAsync(eventLogPath: string): Promise<string[]> {
+  try {
+    await fs.promises.access(eventLogPath);
+    return [eventLogPath];
+  } catch (err) {
+    // The tool-server has not created the file yet — expected until the first event is written.
+    // Surface any other error (permissions, I/O) to the engine so it reaches Sentry.
+    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
+      return [];
+    }
+    throw err;
+  }
+}
+
+function parseArgentEvent(line: string): ParsedArgentEvent {
+  if (!line.trim()) {
+    return {};
+  }
+  try {
+    const result = ArgentEventSchema.safeParse(JSON.parse(line));
+    return result.success ? { event: result.data } : { failure: 'invalid-event' };
+  } catch {
+    return { failure: 'invalid-json' };
+  }
+}
+
+function normalizeArgentEvent({
+  event,
+  sequenceNumber,
+  sourceKey,
+  deviceRunSessionId,
+}: {
+  event: ArgentEvent;
+  sequenceNumber: number;
+  sourceKey: string;
+  deviceRunSessionId: string;
+}): DeviceRunSessionEvent {
+  const type = ARGENT_EVENT_TYPE_TO_TYPE[event.type] ?? event.type;
+  const outcome =
+    event.type === 'tool.completed'
+      ? 'success'
+      : event.type === 'tool.failed'
+        ? 'failure'
+        : undefined;
+  const data: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(event)) {
+    if (!NON_DATA_KEYS.has(key) && value !== undefined) {
+      data[key] = value;
+    }
+  }
+  data.sourceType = event.type;
+  if (typeof event.level === 'number') {
+    data.sourceLevel = event.level;
+  }
+
+  return {
+    v: 1,
+    // Consumers use eventId to deduplicate events across polls. Keep the per-file sequence
+    // monotonic across source-file truncations so an ID is never reused during collection.
+    eventId: `argent:${deviceRunSessionId}:${sourceKey}:${sequenceNumber}`,
+    ts: event.time,
+    producer: 'argent',
+    type,
+    ...(event.toolInvocationId ? { operationId: event.toolInvocationId } : {}),
+    ...(outcome ? { outcome } : {}),
+    ...(typeof event.durationMs === 'number' ? { durationMs: event.durationMs } : {}),
+    summary: event.msg,
+    data,
+  };
+}
@@ -2,10 +2,8 @@ import { SystemError } from '@expo/eas-build-job';
 import { type bunyan } from '@expo/logger';
 import { graphql } from 'gql.tada';
 import fs from 'node:fs';
-import path from 'node:path';
 import { StringDecoder } from 'node:string_decoder';
 import { setTimeout as setTimeoutAsync } from 'node:timers/promises';
-import { z } from 'zod';

 import { type CustomBuildContext } from '../../customBuildContext';
 import RemoteLoggerStream from '../../logging/RemoteLoggerStream';
@@ -15,26 +13,6 @@ import { type SignedUrl } from '../../storage/uploadWithSignedUrl';
 const POLL_INTERVAL_MS = 1_000;
 const UPLOAD_INTERVAL_MS = 5_000;

-const AGENT_DEVICE_EVENT_KIND_TO_TYPE: Record<string, string> = {
-  'request.started': 'operation.started',
-  'request.finished': 'operation.completed',
-  'action.recorded': 'interaction.recorded',
-};
-
-const AgentDeviceEventSchema = z
-  .object({
-    version: z.number(),
-    ts: z.string(),
-    session: z.string(),
-    kind: z.string(),
-    requestId: z.string().optional().catch(undefined),
-    command: z.string().optional().catch(undefined),
-    status: z.string().optional().catch(undefined),
-    summary: z.string().optional().catch(undefined),
-    details: z.record(z.string(), z.unknown()).optional().catch(undefined),
-  })
-  .passthrough();
-
 const CREATE_DEVICE_RUN_SESSION_EVENT_LOG_UPLOAD_SESSION_MUTATION = graphql(`
  mutation CreateDeviceRunSessionEventLogUploadSession($deviceRunSessionId: ID!) {
    deviceRunSession {
@@ -48,8 +26,12 @@ const CREATE_DEVICE_RUN_SESSION_EVENT_LOG_UPLOAD_SESSION_MUTATION = graphql(`
  }
 `);

-type AgentDeviceEvent = z.infer<typeof AgentDeviceEventSchema>;
-
+/**
+ * The normalized, producer-agnostic event shape uploaded to the API server.
+ * Every remote-session producer (agent-device, argent, ...) tails its own
+ * event log and maps its records onto this common contract so consumers render
+ * a single unified session timeline.
+ */
 export type DeviceRunSessionEvent = {
  v: 1;
  eventId: string;
@@ -63,6 +45,44 @@ export type DeviceRunSessionEvent = {
  data?: Record<string, unknown>;
 };

+export type DeviceRunSessionEventParseFailure = 'invalid-json' | 'invalid-event';
+
+export type DeviceRunSessionEventParseResult = {
+  event?: DeviceRunSessionEvent;
+  failure?: DeviceRunSessionEventParseFailure;
+};
+
+/**
+ * Producer-specific adapter plugged into the generic collection engine. It only
+ * has to say where its event files live and how to turn one raw NDJSON line
+ * into a {@link DeviceRunSessionEvent}; the engine owns tailing, upload, polling
+ * and failure reporting.
+ */
+export type DeviceRunSessionEventSource = {
+  /**
+   * Stable producer identifier, e.g. `agent-device` or `argent`. Also used
+   * verbatim in diagnostic messages, which are phrased so it never needs
+   * recasing.
+   */
+  producer: string;
+  /** Discover the NDJSON event files to tail (absolute paths). */
+  findEventFilesAsync: () => Promise<string[]>;
+  /** Namespace component of the event ID derived from a tailed file path. */
+  sourceKeyForFile: (eventFile: string) => string;
+  /**
+   * Parse one raw NDJSON line. `sequenceNumber` is monotonic per file (kept
+   * stable across truncations) and `sourceKey` namespaces the event ID so an ID
+   * is never reused during collection. Blank lines should return an empty
+   * result so they neither emit an event nor count as a parse failure.
+   */
+  parseLine: (args: {
+    line: string;
+    sourceKey: string;
+    sequenceNumber: number;
+    deviceRunSessionId: string;
+  }) => DeviceRunSessionEventParseResult;
+};
+
 type EventFileState = {
  offset: number;
  nextSequenceNumber: number;
@@ -71,25 +91,20 @@ type EventFileState = {
  decoder: StringDecoder;
 };

-type AgentDeviceEventParseFailure = 'invalid-json' | 'invalid-event';
-type AgentDeviceEventParseResult = {
-  event?: AgentDeviceEvent;
-  failure?: AgentDeviceEventParseFailure;
-};
-
-export async function startAgentDeviceEventCollectionAsync({
+export async function startDeviceRunSessionEventCollectionAsync({
  ctx,
  deviceRunSessionId,
-  stateDir,
+  source,
  logger,
  pollIntervalMs = POLL_INTERVAL_MS,
 }: {
  ctx: CustomBuildContext;
  deviceRunSessionId: string;
-  stateDir: string;
+  source: DeviceRunSessionEventSource;
  logger: bunyan;
  pollIntervalMs?: number;
 }): Promise<{ stopAsync: () => Promise<void> }> {
+  const { producer } = source;
  let didReportEventLogFailure = false;
  const reportEventLogFailure = (error: Error, operation: 'setup' | 'cleanup'): void => {
    if (didReportEventLogFailure) {
@@ -98,7 +113,7 @@ export async function startAgentDeviceEventCollectionAsync({
    didReportEventLogFailure = true;
    Sentry.capture('Could not persist device run session events', error, {
      level: 'warning',
-      tags: { phase: 'device-run-session-event-collection', operation },
+      tags: { phase: 'device-run-session-event-collection', operation, producer },
      extras: { deviceRunSessionId },
    });
  };
@@ -124,13 +139,13 @@ export async function startAgentDeviceEventCollectionAsync({
  const states = new Map<string, EventFileState>();
  const controller = new AbortController();
  let parseFailureCount = 0;
-  const parseFailureCounts: Record<AgentDeviceEventParseFailure, number> = {
+  const parseFailureCounts: Record<DeviceRunSessionEventParseFailure, number> = {
    'invalid-json': 0,
    'invalid-event': 0,
  };
  let didReportCollectionFailure = false;
  const collectAsync = async (): Promise<void> => {
-    const eventFiles = await findAgentDeviceEventFilesAsync(stateDir);
+    const eventFiles = await source.findEventFilesAsync();
    await Promise.all(
      eventFiles.map(async eventFile => {
        const state = states.get(eventFile) ?? {
@@ -144,6 +159,7 @@ export async function startAgentDeviceEventCollectionAsync({
        await collectEventFileAsync({
          eventFile,
          state,
+          source,
          deviceRunSessionId,
          writeEvent: event => eventLogStream.write(event),
          onParseFailure: ({ failure, lineNumber }) => {
@@ -153,12 +169,12 @@ export async function startAgentDeviceEventCollectionAsync({
              return;
            }
            logger.warn(
-              { agentDeviceEventParseFailure: failure, lineNumber },
-              'Could not parse an agent-device event log record.'
+              { producer, eventParseFailure: failure, lineNumber },
+              `Could not parse an ${producer} event log record.`
            );
-            Sentry.capture('Could not parse an agent-device event log record', {
+            Sentry.capture(`Could not parse an ${producer} event log record`, {
              level: 'warning',
-              tags: { phase: 'agent-device-event-collection', reason: failure },
+              tags: { phase: `${producer}-event-collection`, reason: failure },
              extras: { deviceRunSessionId, lineNumber },
            });
          },
@@ -176,10 +192,10 @@ export async function startAgentDeviceEventCollectionAsync({
      }
      didReportCollectionFailure = true;
      const error = err instanceof Error ? err : new Error(String(err));
-      logger.warn({ err: error }, 'Could not collect agent-device events.');
-      Sentry.capture('Could not collect agent-device events', error, {
+      logger.warn({ err: error }, `Could not collect ${producer} events.`);
+      Sentry.capture(`Could not collect ${producer} events`, error, {
        level: 'warning',
-        tags: { phase: 'agent-device-event-collection' },
+        tags: { phase: `${producer}-event-collection` },
        extras: { deviceRunSessionId },
      });
    }
@@ -200,10 +216,10 @@ export async function startAgentDeviceEventCollectionAsync({
  })()
    .catch(err => {
      const error = err instanceof Error ? err : new Error(String(err));
-      logger.warn({ err: error }, 'Agent-device event collection poller failed.');
-      Sentry.capture('Agent-device event collection poller failed', error, {
+      logger.warn({ err: error }, `Event collection poller for ${producer} failed.`);
+      Sentry.capture(`Event collection poller for ${producer} failed`, error, {
        level: 'warning',
-        tags: { phase: 'agent-device-event-collection', operation: 'poll' },
+        tags: { phase: `${producer}-event-collection`, operation: 'poll' },
        extras: { deviceRunSessionId },
      });
    })
@@ -218,12 +234,12 @@ export async function startAgentDeviceEventCollectionAsync({
      await collectSafelyAsync();
      if (parseFailureCount > 1) {
        logger.warn(
-          { agentDeviceEventParseFailures: parseFailureCounts, parseFailureCount },
-          `Could not parse ${parseFailureCount} agent-device event log records.`
+          { producer, eventParseFailures: parseFailureCounts, parseFailureCount },
+          `Could not parse ${parseFailureCount} ${producer} event log records.`
        );
-        Sentry.capture('Could not parse multiple agent-device event log records', {
+        Sentry.capture(`Could not parse multiple ${producer} event log records`, {
          level: 'warning',
-          tags: { phase: 'agent-device-event-collection' },
+          tags: { phase: `${producer}-event-collection` },
          extras: { deviceRunSessionId, parseFailureCount, parseFailureCounts },
        });
      }
@@ -260,35 +276,23 @@ async function createEventLogUploadSessionAsync(
  };
 }

-async function findAgentDeviceEventFilesAsync(stateDir: string): Promise<string[]> {
-  const sessionsDir = path.join(stateDir, 'sessions');
-  let entries: fs.Dirent[];
-  try {
-    entries = await fs.promises.readdir(sessionsDir, { withFileTypes: true });
-  } catch (err) {
-    if ((err as NodeJS.ErrnoException).code === 'ENOENT') {
-      return [];
-    }
-    throw err;
-  }
-
-  return entries
-    .filter(entry => entry.isDirectory())
-    .map(entry => path.join(sessionsDir, entry.name, 'events.ndjson'));
-}
-
 async function collectEventFileAsync({
  eventFile,
  state,
+  source,
  deviceRunSessionId,
  writeEvent,
  onParseFailure,
 }: {
  eventFile: string;
  state: EventFileState;
+  source: DeviceRunSessionEventSource;
  deviceRunSessionId: string;
  writeEvent: (event: DeviceRunSessionEvent) => void;
-  onParseFailure: (failure: { failure: AgentDeviceEventParseFailure; lineNumber: number }) => void;
+  onParseFailure: (failure: {
+    failure: DeviceRunSessionEventParseFailure;
+    lineNumber: number;
+  }) => void;
 }): Promise<void> {
  let fileSize: number;
  try {
@@ -309,6 +313,7 @@ async function collectEventFileAsync({
    return;
  }

+  const sourceKey = source.sourceKeyForFile(eventFile);
  const handle = await fs.promises.open(eventFile, 'r');
  try {
    const buffer = new Uint8Array(new ArrayBuffer(fileSize - state.offset));
@@ -321,80 +326,21 @@ async function collectEventFileAsync({
    for (const line of lines) {
      const lineNumber = state.nextLineNumber++;
      const sequenceNumber = state.nextSequenceNumber++;
-      const { event, failure } = parseAgentDeviceEvent(line);
+      const { event, failure } = source.parseLine({
+        line,
+        sourceKey,
+        sequenceNumber,
+        deviceRunSessionId,
+      });
      if (failure) {
        onParseFailure({ failure, lineNumber });
      }
      if (!event) {
        continue;
      }
-      const deviceRunSessionEvent = normalizeAgentDeviceEvent({
-        event,
-        sequenceNumber,
-        sourceSessionDirectory: path.basename(path.dirname(eventFile)),
-        deviceRunSessionId,
-      });
-      writeEvent(deviceRunSessionEvent);
+      writeEvent(event);
    }
  } finally {
    await handle.close();
  }
 }
-
-function parseAgentDeviceEvent(line: string): AgentDeviceEventParseResult {
-  if (!line.trim()) {
-    return {};
-  }
-  try {
-    const result = AgentDeviceEventSchema.safeParse(JSON.parse(line));
-    return result.success ? { event: result.data } : { failure: 'invalid-event' };
-  } catch {
-    return { failure: 'invalid-json' };
-  }
-}
-
-function normalizeAgentDeviceEvent({
-  event,
-  sequenceNumber,
-  sourceSessionDirectory,
-  deviceRunSessionId,
-}: {
-  event: AgentDeviceEvent;
-  sequenceNumber: number;
-  sourceSessionDirectory: string;
-  deviceRunSessionId: string;
-}): DeviceRunSessionEvent {
-  const type = AGENT_DEVICE_EVENT_KIND_TO_TYPE[event.kind] ?? event.kind;
-  const durationMs = event.details?.durationMs;
-  const outcome =
-    event.status === 'ok' ? 'success' : event.status === 'error' ? 'failure' : undefined;
-  const summary =
-    event.summary ??
-    (event.kind === 'request.started'
-      ? `Started ${event.command ?? 'activity'}`
-      : event.kind === 'request.finished'
-        ? `Finished ${event.command ?? 'activity'}`
-        : event.kind === 'action.recorded'
-          ? `Recorded ${event.command ?? 'activity'}`
-          : `${event.kind}${event.command ? `: ${event.command}` : ''}`);
-
-  return {
-    v: 1,
-    // Consumers use eventId to deduplicate events across polls. Keep the per-file sequence
-    // monotonic across source-file truncations so an ID is never reused during collection.
-    eventId: `agent-device:${deviceRunSessionId}:${sourceSessionDirectory}:${sequenceNumber}`,
-    ts: event.ts,
-    producer: 'agent-device',
-    type,
-    ...(event.requestId ? { operationId: event.requestId } : {}),
-    ...(outcome ? { outcome } : {}),
-    ...(typeof durationMs === 'number' ? { durationMs } : {}),
-    summary,
-    data: {
-      ...event.details,
-      session: event.session,
-      sourceVersion: event.version,
-      ...(event.status ? { sourceStatus: event.status } : {}),
-    },
-  };
-}
@@ -1,6 +1,6 @@
 {
  "name": "create-eas-build-function",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "description": "Create functions for use in EAS Build custom builds.",
  "keywords": [
    "expo",
@@ -35,7 +35,7 @@
    "clean": "rimraf ./build/ \"*.tsbuildinfo\""
  },
  "dependencies": {
-    "@expo/steps": "21.3.0"
+    "@expo/steps": "21.4.0"
  },
  "devDependencies": {
    "@expo/package-manager": "1.9.10",
@@ -1,6 +1,6 @@
 {
  "name": "@expo/eas-build-job",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "bugs": "https://github.com/expo/eas-cli/issues",
  "license": "MIT",
  "author": "Expo <[email protected]>",
@@ -0,0 +1,50 @@
+import { DeviceRunSessionEvent, parseDeviceRunSessionEvents } from '../deviceRunSession';
+
+describe('parseDeviceRunSessionEvents', () => {
+  it('parses, deduplicates, and sorts events from the dedicated event log', () => {
+    const first = createEvent({
+      eventId: 'first',
+      ts: '2026-07-10T12:00:00.000Z',
+    });
+    const second = createEvent({
+      eventId: 'second',
+      ts: '2026-07-10T12:00:01.000Z',
+    });
+
+    expect(
+      parseDeviceRunSessionEvents(`${second}\nplain text\n${first}\n${second}`).map(
+        ({ eventId }) => eventId
+      )
+    ).toEqual(['first', 'second']);
+  });
+
+  it('ignores malformed events', () => {
+    expect(parseDeviceRunSessionEvents(`plain text\n${JSON.stringify({ v: 1 })}`)).toEqual([]);
+  });
+
+  it('ignores events with invalid timestamps', () => {
+    expect(
+      parseDeviceRunSessionEvents(
+        `${createEvent({ eventId: 'invalid', ts: 'not-a-date' })}\n${createEvent({
+          eventId: 'valid',
+        })}`
+      ).map(({ eventId }) => eventId)
+    ).toEqual(['valid']);
+  });
+});
+
+function createEvent(overrides: Partial<DeviceRunSessionEvent> = {}): string {
+  return JSON.stringify(createEventValue(overrides));
+}
+
+function createEventValue(overrides: Partial<DeviceRunSessionEvent> = {}): DeviceRunSessionEvent {
+  return {
+    v: 1,
+    eventId: 'event-id',
+    ts: '2026-07-10T12:00:00.000Z',
+    producer: 'agent-device',
+    type: 'operation.started',
+    summary: 'Started tap',
+    ...overrides,
+  };
+}
@@ -0,0 +1,48 @@
+import { z } from 'zod';
+
+/**
+ * Canonical record format for the activity events emitted during a remote device run (simulator)
+ * session. Producers (e.g. the worker and agent-device) write these as NDJSON to the
+ * session-events artifact and consumers (e.g. EAS CLI and the website) read them back. Keep this
+ * schema in sync across every producer and consumer.
+ */
+export const DeviceRunSessionEventZ = z
+  .object({
+    v: z.literal(1),
+    eventId: z.string(),
+    ts: z.string().refine(ts => !Number.isNaN(new Date(ts).getTime())),
+    producer: z.string(),
+    type: z.string(),
+    operationId: z.string().optional(),
+    outcome: z.enum(['success', 'failure']).optional(),
+    durationMs: z.number().optional(),
+    summary: z.string(),
+    data: z.record(z.string(), z.unknown()).optional(),
+  })
+  .passthrough();
+
+export type DeviceRunSessionEvent = z.infer<typeof DeviceRunSessionEventZ>;
+
+/**
+ * Parse the NDJSON session-events log into canonical event records, de-duplicating by `eventId`
+ * and sorting chronologically by `ts`. Malformed or incomplete lines (including records with
+ * invalid timestamps) are ignored so that a partially-flushed log is still readable.
+ */
+export function parseDeviceRunSessionEvents(eventLog: string): DeviceRunSessionEvent[] {
+  const events = new Map<string, DeviceRunSessionEvent>();
+
+  for (const line of eventLog.split('\n')) {
+    try {
+      const result = DeviceRunSessionEventZ.safeParse(JSON.parse(line));
+      if (result.success) {
+        events.set(result.data.eventId, result.data);
+      }
+    } catch {
+      // Ignore malformed or incomplete records.
+    }
+  }
+
+  return [...events.values()].sort(
+    (left, right) => new Date(left.ts).getTime() - new Date(right.ts).getTime()
+  );
+}
@@ -29,6 +29,7 @@ export * from './step';
 export * from './compositeFunction';
 export * from './submission-config';
 export * from './projectPackage';
+export * from './deviceRunSession';

 const version = require('../package.json').version;
 export { version };
@@ -1,6 +1,6 @@
 {
  "name": "eas-cli",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "description": "EAS command line tool",
  "keywords": [
    "cli",
@@ -48,8 +48,8 @@
    "@expo/code-signing-certificates": "0.0.5",
    "@expo/config": "55.0.10",
    "@expo/config-plugins": "55.0.7",
-    "@expo/eas-build-job": "21.3.0",
-    "@expo/eas-json": "21.3.0",
+    "@expo/eas-build-job": "21.4.0",
+    "@expo/eas-json": "21.4.0",
    "@expo/env": "^1.0.0",
    "@expo/json-file": "8.3.3",
    "@expo/logger": "21.0.0",
@@ -64,7 +64,7 @@
    "@expo/results": "1.0.0",
    "@expo/rudder-sdk-node": "1.1.1",
    "@expo/spawn-async": "1.7.2",
-    "@expo/steps": "21.3.0",
+    "@expo/steps": "21.4.0",
    "@expo/timeago.js": "1.0.0",
    "@oclif/core": "^4.8.3",
    "@oclif/plugin-autocomplete": "^3.2.40",
@@ -1,11 +1,35 @@
 const fs = require('fs/promises');
+const path = require('path');
+
+const packageRoot = path.join(__dirname, '..');
+const readmePath = path.join(packageRoot, 'README.md');
+const readmeHeaderPath = path.join(__dirname, 'readme-header.md');

 (async () => {
  // Patch `oclif readme` path and link generation
-  let readmeContent = await fs.readFile('README.md', 'utf8');
-  readmeContent = readmeContent.replace(/src\/commands/g, 'packages/eas-cli/src/commands');
-  await fs.writeFile('README.md', readmeContent);
+  let readmeContent = await fs.readFile(readmePath, 'utf8');
+  readmeContent = readmeContent
+    .replace(/\[src\/commands/g, '[packages/eas-cli/src/commands')
+    .replace(
+      /https:\/\/github\.com\/expo\/eas-cli\/blob\/v([^/]+)\/src\/commands/g,
+      'https://github.com/expo/eas-cli/blob/v$1/packages/eas-cli/src/commands'
+    )
+    .replace(
+      /packages\/eas-cli\/(?:packages\/eas-cli\/)+src\/commands/g,
+      'packages/eas-cli/src/commands'
+    );
+
+  const commandReferenceMarker = '# Commands\n\n<!-- commands -->';
+  const commandReferenceStart = readmeContent.indexOf(commandReferenceMarker);
+  if (commandReferenceStart === -1) {
+    throw new Error(`Could not find generated command reference marker in ${readmePath}`);
+  }
+
+  const readmeHeader = await fs.readFile(readmeHeaderPath, 'utf8');
+  readmeContent = `${readmeHeader.trimEnd()}\n\n${readmeContent.slice(commandReferenceStart)}`;
+
+  await fs.writeFile(readmePath, readmeContent);

  // eslint-disable-next-line no-console
-  console.log('Patched README path generation');
+  console.log('Patched README path generation and header');
 })();
@@ -0,0 +1,117 @@
+<!-- Everything above the "# Commands" section is generated from packages/eas-cli/scripts/readme-header.md. Edit that file, not README.md; `yarn version` regenerates README.md and overwrites this content. -->
+
+<!-- The logo src is an absolute URL on purpose: this file is also the repository root README (README.md is a symlink to it), so it renders at two different depths and no single relative path resolves in both. -->
+
+<p align="center">
+  <a href="https://expo.dev/services">
+    <img alt="EAS" height="96" src="https://raw.githubusercontent.com/expo/eas-cli/main/.github/resources/eas.svg">
+  </a>
+</p>
+
+<h1 align="center">EAS CLI</h1>
+
+<p align="center">Ship Expo and React Native apps from your terminal: build, submit, update, deploy, and automate with EAS.</p>
+
+<p align="center">
+  <a aria-label="eas documentation" href="https://docs.expo.dev/eas/">📚 Documentation</a>
+  &ensp;•&ensp;
+  <a aria-label="eas cli reference" href="https://docs.expo.dev/eas/cli/">📖 CLI Reference</a>
+  &ensp;•&ensp;
+  <a aria-label="eas" href="https://expo.dev/services">🚀 EAS</a>
+  &ensp;•&ensp;
+  <a aria-label="expo blog" href="https://expo.dev/blog">📝 Blog</a>
+  &ensp;•&ensp;
+  <a aria-label="expo changelog" href="https://expo.dev/changelog">📰 Changelog</a>
+  &ensp;•&ensp;
+  <a aria-label="contribute to eas cli" href="https://github.com/expo/eas-cli/blob/main/CONTRIBUTING.md">👏 Contribute</a>
+</p>
+
+<p align="center">
+  <a aria-label="npm version" href="https://www.npmjs.com/package/eas-cli" target="_blank">
+    <img alt="npm version" src="https://img.shields.io/npm/v/eas-cli.svg?style=for-the-badge&label=npm&labelColor=000000&color=4630EB" />
+  </a>
+  <a aria-label="npm downloads" href="https://npm-stat.com/charts.html?package=eas-cli" target="_blank">
+    <img alt="downloads" src="https://img.shields.io/npm/dm/eas-cli.svg?style=for-the-badge&labelColor=000000&color=33CC12&label=downloads" />
+  </a>
+  <a aria-label="License: MIT" href="https://github.com/expo/eas-cli/blob/main/LICENSE" target="_blank">
+    <img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-success.svg?style=for-the-badge&labelColor=000000&color=33CC12" />
+  </a>
+  <a aria-label="Join the Expo Discord" href="https://chat.expo.dev" target="_blank">
+    <img alt="Discord" src="https://img.shields.io/discord/695411232856997968.svg?style=for-the-badge&color=5865F2&logo=discord&logoColor=FFFFFF" />
+  </a>
+</p>
+
+---
+
+EAS CLI is the command-line interface for [Expo Application Services (EAS)](https://expo.dev/services): deeply integrated cloud services for Expo and React Native apps, from the team behind Expo.
+
+It gives you a terminal-native path from source code to production: compile signed Android and iOS binaries in the cloud, submit them to the app stores, push over-the-air updates, deploy web apps and API routes, and automate the entire release process, from your machine or from CI.
+
+## Quick start
+
+Install the CLI, log in to your Expo account, and link your project:
+
+```sh
+npm install --global eas-cli
+eas login
+eas init
+```
+
+Then ship:
+
+```sh
+# Compile installable Android and iOS binaries in the cloud
+eas build --platform all
+
+# Submit the latest builds to Google Play and the App Store
+eas submit --platform all
+
+# Push an over-the-air update to your users
+eas update --branch production --message "Fix checkout crash"
+```
+
+Prefer not to install globally? Every command also works with `npx eas-cli@latest`:
+
+```sh
+npx eas-cli@latest build --platform ios
+```
+
+New to EAS? Follow [Create your first build](https://docs.expo.dev/build/setup/) for a complete walkthrough.
+
+## What you can do
+
+- **[EAS Build](https://docs.expo.dev/build/introduction/)** (`eas build`): compile and sign Android and iOS apps with custom native code in the cloud, manage app credentials, and share internal distribution builds.
+- **[EAS Submit](https://docs.expo.dev/deploy/submit-to-app-stores/)** (`eas submit`): upload your app to Google Play and App Store Connect with one command.
+- **[EAS Update](https://docs.expo.dev/eas-update/introduction/)** (`eas update`): push JavaScript and asset fixes directly to users, with branches, channels, runtime versions, rollouts, and rollbacks.
+- **[EAS Workflows](https://docs.expo.dev/eas/workflows/get-started/)** (`eas workflow`): automate development and release with CI/CD jobs that build, test, submit, update, and deploy your app from `.eas/workflows`.
+- **[EAS Hosting](https://docs.expo.dev/eas/hosting/introduction/)** (`eas deploy`): deploy Expo Router and React Native web apps and API routes.
+- **[EAS Metadata](https://docs.expo.dev/eas/metadata/)** (`eas metadata:push`): maintain your app store presence from the command line (in preview).
+- **Project operations** (`eas env`, `eas credentials`, `eas device`, `eas channel`, …): manage environment variables, signing credentials, Apple devices, update channels, webhooks, and project settings.
+
+## Version policy
+
+EAS CLI is designed to be installed globally or run with `npx`. Installing `eas-cli` into project dependencies is strongly discouraged because it can cause dependency conflicts that are difficult to debug.
+
+If you want to enforce the `eas-cli` version for your project, use the `"cli.version"` field in [eas.json](https://docs.expo.dev/eas/json/):
+
+```json
+{
+  "cli": {
+    "version": ">=21.0.0"
+  },
+  "build": {
+    // build profiles
+  },
+  "submit": {
+    // submit profiles
+  }
+}
+```
+
+## Learn more
+
+- [EAS documentation](https://docs.expo.dev/eas/) for the full service overview.
+- [EAS CLI reference](https://docs.expo.dev/eas/cli/) for command usage, flags, and arguments.
+- [Expo dashboard](https://expo.dev/) to view projects, builds, submissions, updates, and workflows.
+- [Expo changelog](https://expo.dev/changelog) and [blog](https://expo.dev/blog) for product updates.
+- [Discord](https://chat.expo.dev) for community support.
@@ -25,23 +25,27 @@ beforeEach(() => {
  jest.resetAllMocks();
 });

-const EXPECTED_STRINGIFIED_GRAPHQL_ERROR_JSON = `[
-  {
-    "name": "GraphQLError",
-    "extensions": {},
-    "message": "Error 1"
-  },
-  {
-    "name": "GraphQLError",
-    "extensions": {},
-    "message": "Error 2"
-  },
-  {
-    "name": "GraphQLError",
-    "extensions": {},
-    "message": "Error 3"
-  }
-]`;
+const EXPECTED_STRINGIFIED_GRAPHQL_ERROR_JSON = `Build request error details:
+{
+  "message": "[GraphQL] Error 1\\n[GraphQL] Error 2\\n[GraphQL] Error 3",
+  "graphQLErrors": [
+    {
+      "name": "GraphQLError",
+      "extensions": {},
+      "message": "Error 1"
+    },
+    {
+      "name": "GraphQLError",
+      "extensions": {},
+      "message": "Error 2"
+    },
+    {
+      "name": "GraphQLError",
+      "extensions": {},
+      "message": "Error 3"
+    }
+  ]
+}`;

 const EXPECTED_EAS_BUILD_DOWN_MESSAGE = `EAS Build is down for maintenance. Try again later. Check ${link(
  'https://status.expo.dev/'
@@ -110,7 +114,7 @@ describe(Build.name, () => {
          handleBuildRequestError(error, platform);
        } catch {}

-        expect(logDebugSpy).toBeCalledWith(undefined);
+        expect(logDebugSpy).not.toHaveBeenCalled();
      });

      it('does it with iOS', async () => {
@@ -122,7 +126,7 @@ describe(Build.name, () => {
          handleBuildRequestError(error, platform);
        } catch {}

-        expect(logDebugSpy).toBeCalledWith(undefined);
+        expect(logDebugSpy).not.toHaveBeenCalled();
      });
    });

@@ -507,6 +511,135 @@ describe(Build.name, () => {
              handleBuildRequestError(error, platform);
            });

+            assertReThrownError(handleBuildRequestErrorThrownError, Error, expectedMessage);
+          });
+        });
+        describe('with empty GraphQL errors and network response details', () => {
+          it('throws base Error class with network and response details', async () => {
+            const platform = Platform.ANDROID;
+            const error = new CombinedError({
+              graphQLErrors: [],
+              networkError: new Error('Request failed: 400 (Bad Request)'),
+              response: {
+                status: 400,
+                statusText: 'Bad Request',
+                headers: {
+                  get: (headerName: string) =>
+                    headerName === 'expo-request-id' ? mockRequestId : null,
+                },
+              },
+            });
+            const expectedMessage =
+              `${EXPECTED_GENERIC_MESSAGE}\n` +
+              'Network error: Request failed: 400 (Bad Request)\n' +
+              'Response status: 400 Bad Request\n' +
+              `Request ID: ${mockRequestId}`;
+
+            const handleBuildRequestErrorThrownError = getError<Error>(() => {
+              handleBuildRequestError(error, platform);
+            });
+
+            assertReThrownError(handleBuildRequestErrorThrownError, Error, expectedMessage);
+          });
+
+          it('logs network and response details to debug', async () => {
+            const platform = Platform.ANDROID;
+            const logDebugSpy = jest.spyOn(Log, 'debug');
+            const error = new CombinedError({
+              graphQLErrors: [],
+              networkError: new Error('Request failed: 400 (Bad Request)'),
+              response: {
+                status: 400,
+                statusText: 'Bad Request',
+                headers: {
+                  get: (headerName: string) =>
+                    headerName === 'expo-request-id' ? mockRequestId : null,
+                },
+              },
+            });
+
+            try {
+              handleBuildRequestError(error, platform);
+            } catch {}
+
+            expect(logDebugSpy).toBeCalledWith(expect.stringContaining('"graphQLErrors": []'));
+            expect(logDebugSpy).toBeCalledWith(
+              expect.stringContaining('"message": "[Network] Request failed: 400 (Bad Request)"')
+            );
+            expect(logDebugSpy).toBeCalledWith(
+              expect.stringContaining('"message": "Request failed: 400 (Bad Request)"')
+            );
+            expect(logDebugSpy).toBeCalledWith(expect.stringContaining('"status": 400'));
+            expect(logDebugSpy).toBeCalledWith(
+              expect.stringContaining(`"expo-request-id": "${mockRequestId}"`)
+            );
+          });
+
+          it('includes the request ID from the x-request-id header when expo-request-id is missing', async () => {
+            const platform = Platform.ANDROID;
+            const error = new CombinedError({
+              graphQLErrors: [],
+              networkError: new Error('Request failed: 400 (Bad Request)'),
+              response: {
+                status: 400,
+                statusText: 'Bad Request',
+                headers: {
+                  get: (headerName: string) =>
+                    headerName === 'x-request-id' ? mockRequestId : null,
+                },
+              },
+            });
+            const expectedMessage =
+              `${EXPECTED_GENERIC_MESSAGE}\n` +
+              'Network error: Request failed: 400 (Bad Request)\n' +
+              'Response status: 400 Bad Request\n' +
+              `Request ID: ${mockRequestId}`;
+
+            const handleBuildRequestErrorThrownError = getError<Error>(() => {
+              handleBuildRequestError(error, platform);
+            });
+
+            assertReThrownError(handleBuildRequestErrorThrownError, Error, expectedMessage);
+          });
+        });
+        describe('with the same request ID in GraphQL error extensions and response headers', () => {
+          it('does not duplicate the request ID line', async () => {
+            const platform = Platform.ANDROID;
+            const graphQLError = getGraphQLError('Error 1', 'UNKNOWN_GRAPHQL_ERROR');
+            const error = new CombinedError({
+              graphQLErrors: [graphQLError],
+              response: {
+                status: 400,
+                statusText: 'Bad Request',
+                headers: {
+                  get: (headerName: string) =>
+                    headerName === 'expo-request-id' ? mockRequestId : null,
+                },
+              },
+            });
+            const expectedMessage =
+              `${EXPECTED_GENERIC_MESSAGE}\n` +
+              `Request ID: ${mockRequestId}\n` +
+              'Error message: Error 1\n' +
+              'Response status: 400 Bad Request';
+
+            const handleBuildRequestErrorThrownError = getError<Error>(() => {
+              handleBuildRequestError(error, platform);
+            });
+
+            assertReThrownError(handleBuildRequestErrorThrownError, Error, expectedMessage);
+          });
+        });
+        describe('with no GraphQL, network, or response details', () => {
+          it('falls back to the top-level error message', async () => {
+            const platform = Platform.ANDROID;
+            const error = { graphQLErrors: [], message: 'Something went wrong' };
+            const expectedMessage = `${EXPECTED_GENERIC_MESSAGE}\nError message: Something went wrong`;
+
+            const handleBuildRequestErrorThrownError = getError<Error>(() => {
+              handleBuildRequestError(error, platform);
+            });
+
            assertReThrownError(handleBuildRequestErrorThrownError, Error, expectedMessage);
          });
        });
@@ -231,12 +231,17 @@ const SERVER_SIDE_DEFINED_ERRORS: Record<string, typeof EasCommandError> = {
 };

 export function handleBuildRequestError(error: any, platform: Platform): never {
-  Log.debug(JSON.stringify(error.graphQLErrors, null, 2));
+  logBuildRequestErrorDebugInfo(error);

-  const graphQLErrorCode: string = error?.graphQLErrors?.[0]?.extensions?.errorCode;
-  if (graphQLErrorCode in SERVER_SIDE_DEFINED_ERRORS) {
+  const graphQLErrors: GraphQLError[] = Array.isArray(error?.graphQLErrors)
+    ? error.graphQLErrors
+    : [];
+  const graphQLErrorCode: string | undefined = graphQLErrors[0]?.extensions?.errorCode as
+    | string
+    | undefined;
+  if (graphQLErrorCode && graphQLErrorCode in SERVER_SIDE_DEFINED_ERRORS) {
    const ErrorClass: typeof EasCommandError = SERVER_SIDE_DEFINED_ERRORS[graphQLErrorCode];
-    throw new ErrorClass(error?.graphQLErrors?.[0]?.message);
+    throw new ErrorClass(graphQLErrors[0]?.message);
  } else if (graphQLErrorCode === 'EAS_BUILD_DOWN_FOR_MAINTENANCE') {
    throw new EasBuildDownForMaintenanceError(
      `EAS Build is down for maintenance. Try again later. Check ${link(
@@ -247,25 +252,128 @@ export function handleBuildRequestError(error: any, platform: Platform): never {
    throw new EasBuildTooManyPendingBuildsError(
      `You have already reached the maximum number of pending ${requestedPlatformDisplayNames[platform]} builds for your account. Try again later.`
    );
-  } else if (error?.graphQLErrors) {
-    const errorMessage = error.graphQLErrors
-      .map((graphQLError: GraphQLError) => {
-        const requestIdLine = graphQLError?.extensions?.requestId
-          ? `\nRequest ID: ${graphQLError.extensions.requestId}`
-          : '';
-        const errorMessageLine = graphQLError?.message
-          ? `\nError message: ${graphQLError.message}`
-          : '';
-        return `${requestIdLine}${errorMessageLine}`;
-      })
-      .join('');
+  } else if (Array.isArray(error?.graphQLErrors)) {
+    const errorDetails = formatBuildRequestErrorDetails(error, graphQLErrors);
    throw new Error(
-      `Build request failed. Make sure you are using the latest eas-cli version. If the problem persists, report the issue.${errorMessage}`
+      `Build request failed. Make sure you are using the latest eas-cli version. If the problem persists, report the issue.${errorDetails}`
    );
  }
  throw error;
 }

+function formatBuildRequestErrorDetails(error: any, graphQLErrors: GraphQLError[]): string {
+  const details: string[] = graphQLErrors
+    .map((graphQLError: GraphQLError) => {
+      const requestIdLine = graphQLError?.extensions?.requestId
+        ? `\nRequest ID: ${graphQLError.extensions.requestId}`
+        : '';
+      const errorMessageLine = graphQLError?.message
+        ? `\nError message: ${graphQLError.message}`
+        : '';
+      return `${requestIdLine}${errorMessageLine}`;
+    })
+    .filter(Boolean);
+
+  if (error?.networkError?.message) {
+    details.push(`\nNetwork error: ${error.networkError.message}`);
+  }
+
+  const response = error?.response;
+  if (response?.status !== undefined || response?.statusText) {
+    const status = [response.status, response.statusText]
+      .filter(value => value !== undefined && value !== '')
+      .join(' ');
+    details.push(`\nResponse status: ${status}`);
+  }
+
+  const responseRequestId = getResponseRequestId(response);
+  const graphQLRequestIds = new Set(
+    graphQLErrors.map(graphQLError => graphQLError?.extensions?.requestId)
+  );
+  if (responseRequestId && !graphQLRequestIds.has(responseRequestId)) {
+    details.push(`\nRequest ID: ${responseRequestId}`);
+  }
+
+  if (details.length === 0 && error?.message) {
+    details.push(`\nError message: ${error.message}`);
+  }
+
+  return details.join('');
+}
+
+function getResponseRequestId(response: any): string | null {
+  return (
+    response?.headers?.get?.('expo-request-id') ?? response?.headers?.get?.('x-request-id') ?? null
+  );
+}
+
+function logBuildRequestErrorDebugInfo(error: any): void {
+  const debugInfo = collectBuildRequestErrorDebugInfo(error);
+  if (debugInfo) {
+    Log.debug(`Build request error details:\n${JSON.stringify(debugInfo, null, 2)}`);
+  }
+}
+
+function collectBuildRequestErrorDebugInfo(error: any): Record<string, unknown> | null {
+  if (!Array.isArray(error?.graphQLErrors) && !error?.response && !error?.networkError) {
+    return null;
+  }
+
+  const debugInfo: Record<string, unknown> = {};
+  if (error?.message) {
+    debugInfo.message = error.message;
+  }
+  if (Array.isArray(error?.graphQLErrors)) {
+    debugInfo.graphQLErrors = error.graphQLErrors;
+  }
+  if (error?.networkError) {
+    debugInfo.networkError = collectErrorDebugInfo(error.networkError);
+  }
+
+  const response = collectResponseDebugInfo(error?.response);
+  if (response) {
+    debugInfo.response = response;
+  }
+
+  return debugInfo;
+}
+
+function collectErrorDebugInfo(error: any): Record<string, unknown> {
+  const debugInfo: Record<string, unknown> = {};
+  for (const property of ['name', 'message', 'code', 'type', 'errno', 'syscall', 'stack']) {
+    if (error?.[property]) {
+      debugInfo[property] = error[property];
+    }
+  }
+  return debugInfo;
+}
+
+function collectResponseDebugInfo(response: any): Record<string, unknown> | null {
+  if (!response) {
+    return null;
+  }
+
+  const debugInfo: Record<string, unknown> = {};
+  for (const property of ['status', 'statusText', 'url']) {
+    if (response[property] !== undefined && response[property] !== '') {
+      debugInfo[property] = response[property];
+    }
+  }
+
+  const headers: Record<string, string> = {};
+  for (const headerName of ['expo-request-id', 'x-request-id', 'content-type']) {
+    const headerValue = response?.headers?.get?.(headerName);
+    if (headerValue) {
+      headers[headerName] = headerValue;
+    }
+  }
+  if (Object.keys(headers).length > 0) {
+    debugInfo.headers = headers;
+  }
+
+  return Object.keys(debugInfo).length > 0 ? debugInfo : null;
+}
+
 async function uploadProjectAsync<TPlatform extends Platform>(
  ctx: BuildContext<TPlatform>
 ): Promise<{
@@ -133,6 +133,17 @@ describe(ObserveEvents, () => {
    expect(options.eventName).toBeUndefined();
  });

+  it('routes to fetchObserveCustomEventsAsync with the session filter when --session-id is set with no positional arg', async () => {
+    const command = createCommand(['--session-id', 'session-xyz']);
+    await command.runAsync();
+
+    expect(mockFetchObserveCustomEventsAsync).toHaveBeenCalledTimes(1);
+    expect(mockCustomEventNamesAsync).not.toHaveBeenCalled();
+    const options = mockFetchObserveCustomEventsAsync.mock.calls[0][2];
+    expect(options.eventName).toBeUndefined();
+    expect(options.sessionId).toBe('session-xyz');
+  });
+
  it('throws when both an event name argument and --all-events are provided', async () => {
    const command = createCommand(['my_event', '--all-events']);
    await expect(command.runAsync()).rejects.toThrow(
@@ -55,7 +55,8 @@ export default class ObserveEvents extends EasCommand {
    ...ObserveAppVersionFlag,
    ...ObserveUpdateIdFlag,
    'session-id': Flags.string({
-      description: 'Filter by session ID',
+      description:
+        'Filter by session ID. When no event name is given, lists the events in the session instead of the event-name summary.',
    }),
    'all-events': Flags.boolean({
      description:
@@ -101,7 +102,10 @@ export default class ObserveEvents extends EasCommand {

    const platform = appObservePlatformFromFlag(flags.platform);

-    if (!args.eventName && !flags['all-events']) {
+    // A session ID narrows to a single session, so show that session's events
+    // (like --all-events) instead of the account-wide name+count summary, which
+    // has no session filter.
+    if (!args.eventName && !flags['all-events'] && !flags['session-id']) {
      const { names, isTruncated } = await withObservePlanGateHandlingAsync(() =>
        ObserveQuery.customEventNamesAsync(graphqlClient, {
          appId: projectId,
@@ -0,0 +1,353 @@
+import { Config } from '@oclif/core';
+
+import { ExpoGraphqlClient } from '../../../commandUtils/context/contextUtils/createGraphqlClient';
+import {
+  DeviceRunSessionEventsByIdQuery,
+  DeviceRunSessionStatus,
+} from '../../../graphql/generated';
+import { DeviceRunSessionQuery } from '../../../graphql/queries/DeviceRunSessionQuery';
+import Log from '../../../log';
+import { loadSimulatorEnvAsync } from '../../../simulator/env';
+import {
+  type DeviceRunSessionEvent,
+  downloadDeviceRunSessionEventsAsync,
+  formatDeviceRunSessionEvent,
+  projectDeviceRunSessionEventsForDisplay,
+} from '../../../simulator/events';
+import { enableJsonOutput, printJsonOnlyOutput } from '../../../utils/json';
+import { sleepAsync } from '../../../utils/promise';
+import SimulatorEvents from '../events';
+
+jest.mock('../../../graphql/queries/DeviceRunSessionQuery');
+jest.mock('../../../log');
+jest.mock('../../../simulator/env', () => ({
+  ...jest.requireActual('../../../simulator/env'),
+  loadSimulatorEnvAsync: jest.fn(),
+}));
+jest.mock('../../../simulator/events');
+jest.mock('../../../utils/json');
+jest.mock('../../../utils/promise');
+
+const mockEventsByIdAsync = jest.mocked(DeviceRunSessionQuery.eventsByIdAsync);
+const mockDownloadEventsAsync = jest.mocked(downloadDeviceRunSessionEventsAsync);
+const mockFormatEvent = jest.mocked(formatDeviceRunSessionEvent);
+const mockLoadSimulatorEnvAsync = jest.mocked(loadSimulatorEnvAsync);
+const mockEnableJsonOutput = jest.mocked(enableJsonOutput);
+const mockPrintJsonOnlyOutput = jest.mocked(printJsonOnlyOutput);
+const mockProjectEvents = jest.mocked(projectDeviceRunSessionEventsForDisplay);
+const mockSleepAsync = jest.mocked(sleepAsync);
+const mockDebug = jest.mocked(Log.debug);
+const mockLog = jest.mocked(Log.log);
+
+function getMockOclifConfig(): Config {
+  const config = new Config({ root: __dirname });
+  config.runHook = async () => ({ failures: [], successes: [] });
+  return config;
+}
+
+describe(SimulatorEvents, () => {
+  const graphqlClient = {} as ExpoGraphqlClient;
+  const projectDir = '/test/project';
+
+  beforeEach(() => {
+    jest.clearAllMocks();
+    mockLoadSimulatorEnvAsync.mockResolvedValue();
+    mockProjectEvents.mockImplementation(events => events);
+    mockFormatEvent.mockImplementation(event => `formatted:${event.eventId}`);
+    mockSleepAsync.mockResolvedValue();
+  });
+
+  it('prints a JSON snapshot for the requested session', async () => {
+    const session: DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId'] = {
+      id: 'session-id',
+      status: DeviceRunSessionStatus.InProgress,
+      artifacts: [
+        {
+          id: 'event-artifact-id',
+          downloadUrl: 'https://example.test/events',
+          metadata: { __eas_type: 'session-events' },
+        },
+      ],
+    };
+    const events = [
+      {
+        v: 1 as const,
+        eventId: 'event-id',
+        ts: '2026-07-10T12:00:00.000Z',
+        producer: 'agent-device',
+        type: 'operation.started',
+        summary: 'Started tap',
+      },
+    ];
+    mockEventsByIdAsync.mockResolvedValue(session);
+    mockDownloadEventsAsync.mockResolvedValue(events);
+    const command = new SimulatorEvents(['--id', 'session-id', '--json'], getMockOclifConfig());
+    // @ts-expect-error getContextAsync is protected
+    jest.spyOn(command, 'getContextAsync').mockResolvedValue({
+      loggedIn: { graphqlClient },
+      projectDir,
+    });
+
+    await command.runAsync();
+
+    expect(mockEnableJsonOutput).toHaveBeenCalled();
+    expect(mockLoadSimulatorEnvAsync).toHaveBeenCalledWith(projectDir);
+    expect(mockEventsByIdAsync).toHaveBeenCalledWith(graphqlClient, 'session-id');
+    expect(mockDownloadEventsAsync).toHaveBeenCalledWith('https://example.test/events');
+    expect(mockPrintJsonOnlyOutput).toHaveBeenCalledWith({
+      deviceRunSessionId: 'session-id',
+      events,
+    });
+    expect(mockProjectEvents).not.toHaveBeenCalled();
+  });
+
+  it('prints an empty snapshot when the session has no event artifact', async () => {
+    mockEventsByIdAsync.mockResolvedValue({
+      id: 'session-id',
+      status: DeviceRunSessionStatus.Stopped,
+      artifacts: [],
+    });
+    const command = new SimulatorEvents(['--id', 'session-id', '--json'], getMockOclifConfig());
+    // @ts-expect-error getContextAsync is protected
+    jest.spyOn(command, 'getContextAsync').mockResolvedValue({
+      loggedIn: { graphqlClient },
+      projectDir,
+    });
+
+    await command.runAsync();
+
+    expect(mockDownloadEventsAsync).not.toHaveBeenCalled();
+    expect(mockPrintJsonOnlyOutput).toHaveBeenCalledWith({
+      deviceRunSessionId: 'session-id',
+      events: [],
+    });
+  });
+
+  it('prints a condensed text snapshot', async () => {
+    const session = createSession(DeviceRunSessionStatus.Stopped);
+    const events = [createEvent()];
+    mockEventsByIdAsync.mockResolvedValue(session);
+    mockDownloadEventsAsync.mockResolvedValue(events);
+    const command = createCommand(['--id', 'session-id']);
+
+    await command.runAsync();
+
+    expect(mockProjectEvents).toHaveBeenCalledWith(events, {
+      includeIncompleteOperations: true,
+    });
+    expect(mockFormatEvent).toHaveBeenCalledWith(events[0]);
+    expect(mockLog).toHaveBeenCalledWith('formatted:event-id');
+  });
+
+  it('refreshes twice after a followed running session stops before flushing incomplete events', async () => {
+    const events = [createEvent()];
+    mockEventsByIdAsync
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.InProgress))
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.Stopped))
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.Stopped))
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.Stopped));
+    mockDownloadEventsAsync.mockResolvedValue(events);
+    mockProjectEvents.mockImplementation((projectedEvents, options) =>
+      options?.includeIncompleteOperations ? projectedEvents : []
+    );
+    const command = createCommand(['--id', 'session-id', '--follow']);
+
+    await command.runAsync();
+
+    expect(mockEventsByIdAsync).toHaveBeenCalledTimes(4);
+    expect(mockDownloadEventsAsync).toHaveBeenCalledTimes(4);
+    expect(mockSleepAsync).toHaveBeenCalledTimes(3);
+    expect(
+      mockProjectEvents.mock.calls.map(([, options]) => options?.includeIncompleteOperations)
+    ).toEqual([false, false, false, true]);
+    expect(mockLog).toHaveBeenCalledTimes(1);
+    expect(mockLog).toHaveBeenCalledWith('formatted:event-id');
+  });
+
+  it('wakes from polling and flushes incomplete events when follow mode is interrupted', async () => {
+    const existingInterruptListeners = new Set(process.listeners('SIGINT'));
+    mockEventsByIdAsync.mockResolvedValue(createSession(DeviceRunSessionStatus.InProgress));
+    const events = [createEvent()];
+    mockDownloadEventsAsync.mockResolvedValue(events);
+    mockProjectEvents.mockImplementation((projectedEvents, options) =>
+      options?.includeIncompleteOperations ? projectedEvents : []
+    );
+    let notifySleepStarted: () => void;
+    const sleepStarted = new Promise<void>(resolve => {
+      notifySleepStarted = resolve;
+    });
+    mockSleepAsync.mockImplementationOnce(() => {
+      notifySleepStarted();
+      return new Promise<void>(() => {});
+    });
+    const command = createCommand(['--id', 'session-id', '--follow']);
+
+    const commandPromise = command.runAsync();
+    await sleepStarted;
+    const interruptHandler = process
+      .listeners('SIGINT')
+      .find(listener => !existingInterruptListeners.has(listener));
+    expect(interruptHandler).toBeDefined();
+    interruptHandler?.('SIGINT');
+    await commandPromise;
+
+    expect(mockEventsByIdAsync).toHaveBeenCalledTimes(1);
+    expect(
+      mockProjectEvents.mock.calls.map(([, options]) => options?.includeIncompleteOperations)
+    ).toEqual([false, true]);
+    expect(mockLog).toHaveBeenCalledWith('formatted:event-id');
+    expect(process.listeners('SIGINT')).toEqual([...existingInterruptListeners]);
+  });
+
+  it('force exits on a second interrupt', async () => {
+    const existingInterruptListeners = new Set(process.listeners('SIGINT'));
+    mockEventsByIdAsync.mockResolvedValue(createSession(DeviceRunSessionStatus.InProgress));
+    mockDownloadEventsAsync.mockResolvedValue([]);
+    let notifySleepStarted: () => void;
+    const sleepStarted = new Promise<void>(resolve => {
+      notifySleepStarted = resolve;
+    });
+    mockSleepAsync.mockImplementationOnce(() => {
+      notifySleepStarted();
+      return new Promise<void>(() => {});
+    });
+    const exitSpy = jest
+      .spyOn(process, 'exit')
+      .mockImplementation((code?: string | number | null): never => {
+        throw new Error(`process.exit(${code})`);
+      });
+    const command = createCommand(['--id', 'session-id', '--follow']);
+
+    try {
+      const commandPromise = command.runAsync();
+      await sleepStarted;
+      const interruptHandler = process
+        .listeners('SIGINT')
+        .find(listener => !existingInterruptListeners.has(listener));
+      expect(interruptHandler).toBeDefined();
+      interruptHandler?.('SIGINT');
+      expect(() => interruptHandler?.('SIGINT')).toThrow('process.exit(130)');
+      await commandPromise;
+
+      expect(exitSpy).toHaveBeenCalledWith(130);
+      expect(process.listeners('SIGINT')).toEqual([...existingInterruptListeners]);
+    } finally {
+      exitSpy.mockRestore();
+    }
+  });
+
+  it('retries transient query and artifact download errors in follow mode', async () => {
+    const events = [createEvent()];
+    mockEventsByIdAsync
+      .mockRejectedValueOnce(new Error('query unavailable'))
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.InProgress))
+      .mockResolvedValueOnce(createSession(DeviceRunSessionStatus.Stopped));
+    mockDownloadEventsAsync
+      .mockRejectedValueOnce(new Error('artifact unavailable'))
+      .mockResolvedValueOnce(events);
+    const command = createCommand(['--id', 'session-id', '--follow']);
+
+    await command.runAsync();
+
+    expect(mockEventsByIdAsync).toHaveBeenCalledTimes(3);
+    expect(mockDownloadEventsAsync).toHaveBeenCalledTimes(2);
+    expect(mockSleepAsync).toHaveBeenCalledTimes(2);
+    expect(mockDebug).toHaveBeenNthCalledWith(
+      1,
+      'Failed to poll simulator session events: query unavailable'
+    );
+    expect(mockDebug).toHaveBeenNthCalledWith(
+      2,
+      'Failed to poll simulator session events: artifact unavailable'
+    );
+    expect(mockLog).toHaveBeenCalledWith('formatted:event-id');
+  });
+
+  it('does not retry query errors outside follow mode', async () => {
+    const existingInterruptListeners = process.listeners('SIGINT');
+    mockEventsByIdAsync.mockRejectedValue(new Error('query unavailable'));
+    const command = createCommand(['--id', 'session-id']);
+
+    await expect(command.runAsync()).rejects.toThrow('query unavailable');
+
+    expect(mockSleepAsync).not.toHaveBeenCalled();
+    expect(mockDebug).not.toHaveBeenCalled();
+    expect(process.listeners('SIGINT')).toEqual(existingInterruptListeners);
+  });
+
+  it('does not register an interrupt handler outside follow mode', async () => {
+    const existingInterruptListeners = process.listeners('SIGINT');
+    let notifyQueryStarted: () => void;
+    const queryStarted = new Promise<void>(resolve => {
+      notifyQueryStarted = resolve;
+    });
+    let resolveSession: (
+      session: DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId']
+    ) => void = () => {
+      throw new Error('Session promise was not initialized.');
+    };
+    const pendingSession = new Promise<
+      DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId']
+    >(resolve => {
+      resolveSession = resolve;
+    });
+    mockEventsByIdAsync.mockImplementationOnce(() => {
+      notifyQueryStarted();
+      return pendingSession;
+    });
+    mockDownloadEventsAsync.mockResolvedValue([]);
+    const command = createCommand(['--id', 'session-id']);
+
+    const commandPromise = command.runAsync();
+    await queryStarted;
+    expect(process.listeners('SIGINT')).toEqual(existingInterruptListeners);
+    resolveSession(createSession(DeviceRunSessionStatus.Stopped));
+    await commandPromise;
+  });
+
+  it('rejects combining JSON and follow output', async () => {
+    const command = new SimulatorEvents(
+      ['--id', 'session-id', '--json', '--follow'],
+      getMockOclifConfig()
+    );
+
+    await expect(command.runAsync()).rejects.toThrow('Use either --json or --follow, not both.');
+  });
+});
+
+function createCommand(args: string[]): SimulatorEvents {
+  const command = new SimulatorEvents(args, getMockOclifConfig());
+  // @ts-expect-error getContextAsync is protected
+  jest.spyOn(command, 'getContextAsync').mockResolvedValue({
+    loggedIn: { graphqlClient: {} as ExpoGraphqlClient },
+    projectDir: '/test/project',
+  });
+  return command;
+}
+
+function createSession(
+  status: DeviceRunSessionStatus
+): DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId'] {
+  return {
+    id: 'session-id',
+    status,
+    artifacts: [
+      {
+        id: 'event-artifact-id',
+        downloadUrl: 'https://example.test/events',
+        metadata: { __eas_type: 'session-events' },
+      },
+    ],
+  };
+}
+
+function createEvent(): DeviceRunSessionEvent {
+  return {
+    v: 1 as const,
+    eventId: 'event-id',
+    ts: '2026-07-10T12:00:00.000Z',
+    producer: 'agent-device',
+    type: 'operation.started',
+    summary: 'Started tap',
+  };
+}
@@ -9,6 +9,7 @@ import {
  JobRunStatus,
 } from '../../../graphql/generated';
 import { DeviceRunSessionQuery } from '../../../graphql/queries/DeviceRunSessionQuery';
+import Log from '../../../log';
 import {
  EAS_SIMULATOR_SESSION_ID,
  SIMULATOR_DOTENV_FILE_NAME,
@@ -46,6 +47,7 @@ const mockPrintJsonOnlyOutput = jest.mocked(printJsonOnlyOutput);
 function makeDeviceRunSession(overrides: Partial<DeviceRunSessionById> = {}): DeviceRunSessionById {
  return {
    id: 'session-123',
+    name: null,
    status: DeviceRunSessionStatus.InProgress,
    type: DeviceRunSessionType.AgentDevice,
    platform: AppPlatform.Ios,
@@ -134,6 +136,7 @@ describe(SimulatorGet, () => {
    expect(mockByIdAsync).toHaveBeenCalledWith(graphqlClient, 'session-123');
    expect(mockPrintJsonOnlyOutput).toHaveBeenCalledWith({
      id: 'session-123',
+      name: undefined,
      type: 'agent-device',
      status: DeviceRunSessionStatus.InProgress,
      platform: AppPlatform.Ios,
@@ -148,6 +151,26 @@ describe(SimulatorGet, () => {
    });
  });

+  it('includes the session name in JSON and human output when the session is named', async () => {
+    mockByIdAsync.mockResolvedValue(makeDeviceRunSession({ name: 'Checkout regression' }));
+
+    const { command } = createCommand(['--id', 'session-123', '--json']);
+    await command.runAsync();
+
+    expect(mockPrintJsonOnlyOutput).toHaveBeenCalledWith(
+      expect.objectContaining({ name: 'Checkout regression' })
+    );
+
+    jest.clearAllMocks();
+    mockLoadSimulatorEnvironmentVariablesAsync.mockResolvedValue();
+    mockByIdAsync.mockResolvedValue(makeDeviceRunSession({ name: 'Checkout regression' }));
+
+    const { command: humanCommand } = createCommand(['--id', 'session-123']);
+    await humanCommand.runAsync();
+
+    expect(Log.log).toHaveBeenCalledWith(expect.stringContaining('Checkout regression'));
+  });
+
  it(`uses ${EAS_SIMULATOR_SESSION_ID} from simulator env when --id is not passed`, async () => {
    const previousDeviceRunSessionId = process.env[EAS_SIMULATOR_SESSION_ID];
    const session = makeDeviceRunSession({ id: 'session-from-env' });
@@ -9,6 +9,7 @@ import {
  JobRunStatus,
 } from '../../../graphql/generated';
 import { DeviceRunSessionQuery } from '../../../graphql/queries/DeviceRunSessionQuery';
+import Log from '../../../log';
 import { enableJsonOutput, printJsonOnlyOutput } from '../../../utils/json';
 import SimulatorList from '../list';

@@ -40,6 +41,7 @@ const mockPrintJsonOnlyOutput = jest.mocked(printJsonOnlyOutput);
 function makeSession(overrides: Partial<DeviceRunSessionNode> = {}): DeviceRunSessionNode {
  return {
    id: 'session-123',
+    name: null,
    status: DeviceRunSessionStatus.InProgress,
    type: DeviceRunSessionType.AgentDevice,
    platform: AppPlatform.Ios,
@@ -129,6 +131,7 @@ describe(SimulatorList, () => {
      sessions: [
        {
          id: 'session-123',
+          name: undefined,
          type: 'agent-device',
          status: DeviceRunSessionStatus.InProgress,
          platform: AppPlatform.Ios,
@@ -180,6 +183,26 @@ describe(SimulatorList, () => {
    });
  });

+  it('prints a name row for every session, named or not', async () => {
+    mockListByAppIdAsync.mockResolvedValue(
+      makeConnection([
+        makeSession({ id: 'session-1', name: 'Checkout regression' }),
+        makeSession({ id: 'session-2' }),
+      ])
+    );
+
+    const { command } = createCommand([]);
+    await command.runAsync();
+
+    const printed = jest
+      .mocked(Log.log)
+      .mock.calls.map(([entry]) => String(entry))
+      .join('\n');
+    expect(printed).toContain('Name:     Checkout regression');
+    expect(printed).toContain('Name:     null');
+    expect(printed.match(/Name:/g)).toHaveLength(2);
+  });
+
  it('runs non-interactively without --json', async () => {
    const session = makeSession({ id: 'session-1', turtleJobRun: null });
    mockListByAppIdAsync.mockResolvedValue(makeConnection([session]));
@@ -99,6 +99,7 @@ function makeCreatedDeviceRunSession(
 function makeDeviceRunSession(overrides: Partial<DeviceRunSessionById> = {}): DeviceRunSessionById {
  return {
    id: 'session-123',
+    name: null,
    status: DeviceRunSessionStatus.InProgress,
    type: DeviceRunSessionType.AgentDevice,
    platform: AppPlatform.Ios,
@@ -189,6 +190,7 @@ describe(SimulatorStart, () => {
    });
    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(graphqlClient, {
      appId: 'project-123',
+      name: undefined,
      packageVersion: undefined,
      platform: AppPlatform.Ios,
      type: DeviceRunSessionType.AgentDevice,
@@ -231,7 +233,7 @@ describe(SimulatorStart, () => {
      [
        '🔑 Run the following to use agent-device with the simulator:',
        '',
-        'eas simulator:exec agent-device <command>',
+        'eas simulator:exec npx agent-device <command>',
        '',
        '🌐 Open the following URL in your browser to preview the simulator:',
        '',
@@ -278,6 +280,7 @@ describe(SimulatorStart, () => {
    );
    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(graphqlClient, {
      appId: 'project-123',
+      name: undefined,
      packageVersion: undefined,
      platform: AppPlatform.Ios,
      type: DeviceRunSessionType.AgentDevice,
@@ -297,6 +300,7 @@ describe(SimulatorStart, () => {
    );
    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(graphqlClient, {
      appId: 'project-123',
+      name: undefined,
      packageVersion: undefined,
      platform: AppPlatform.Ios,
      type: DeviceRunSessionType.AgentDevice,
@@ -325,6 +329,48 @@ describe(SimulatorStart, () => {
    expect(mockResetSimulatorEnvAsync).toHaveBeenCalledWith(projectDir);
  });

+  it('forwards --name to the create mutation', async () => {
+    const { command } = createCommand([
+      '--platform',
+      'ios',
+      '--non-interactive',
+      '--name',
+      'Checkout regression',
+    ]);
+    await command.runAsync();
+
+    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(
+      graphqlClient,
+      expect.objectContaining({ name: 'Checkout regression' })
+    );
+  });
+
+  it('trims --name before sending it', async () => {
+    const { command } = createCommand([
+      '--platform',
+      'ios',
+      '--non-interactive',
+      '--name',
+      '  Checkout regression  ',
+    ]);
+    await command.runAsync();
+
+    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(
+      graphqlClient,
+      expect.objectContaining({ name: 'Checkout regression' })
+    );
+  });
+
+  it('omits a blank --name instead of letting the server reject it', async () => {
+    const { command } = createCommand(['--platform', 'ios', '--non-interactive', '--name', '   ']);
+    await command.runAsync();
+
+    expect(mockCreateDeviceRunSessionAsync).toHaveBeenCalledWith(
+      graphqlClient,
+      expect.objectContaining({ name: undefined })
+    );
+  });
+
  it('prompts to select the platform when --platform is omitted', async () => {
    mockPromptAsync.mockResolvedValueOnce({ selectedPlatform: AppPlatform.Android });
    mockByIdAsync
@@ -0,0 +1,180 @@
+import { Flags } from '@oclif/core';
+
+import EasCommand from '../../commandUtils/EasCommand';
+import {
+  EasNonInteractiveAndJsonFlags,
+  resolveNonInteractiveAndJsonFlags,
+} from '../../commandUtils/flags';
+import {
+  type DeviceRunSessionEventsByIdQuery,
+  DeviceRunSessionStatus,
+} from '../../graphql/generated';
+import { DeviceRunSessionQuery } from '../../graphql/queries/DeviceRunSessionQuery';
+import Log from '../../log';
+import {
+  EAS_SIMULATOR_SESSION_ID,
+  SIMULATOR_DOTENV_FILE_NAME,
+  loadSimulatorEnvAsync,
+} from '../../simulator/env';
+import {
+  type DeviceRunSessionEvent,
+  downloadDeviceRunSessionEventsAsync,
+  formatDeviceRunSessionEvent,
+  projectDeviceRunSessionEventsForDisplay,
+} from '../../simulator/events';
+import { enableJsonOutput, printJsonOnlyOutput } from '../../utils/json';
+import { sleepAsync } from '../../utils/promise';
+
+const POLL_INTERVAL_MS = 5_000;
+const POST_STOP_REFRESH_COUNT = 2;
+
+export default class SimulatorEvents extends EasCommand {
+  static override hidden = true;
+  static override description =
+    '[EXPERIMENTAL] show activity events from a remote simulator session';
+
+  static override flags = {
+    id: Flags.string({
+      description: `Simulator session ID. Defaults to ${SIMULATOR_DOTENV_FILE_NAME}.`,
+    }),
+    follow: Flags.boolean({
+      char: 'f',
+      description: 'Keep watching for new events until the session ends.',
+    }),
+    ...EasNonInteractiveAndJsonFlags,
+  };
+
+  static override contextDefinition = {
+    ...this.ContextOptions.LoggedIn,
+    ...this.ContextOptions.ProjectDir,
+  };
+
+  async runAsync(): Promise<void> {
+    const { flags } = await this.parse(SimulatorEvents);
+    const { json: jsonFlag, nonInteractive } = resolveNonInteractiveAndJsonFlags(flags);
+    if (jsonFlag && flags.follow) {
+      throw new Error('Use either --json or --follow, not both.');
+    }
+    if (jsonFlag) {
+      enableJsonOutput();
+    }
+
+    const {
+      projectDir,
+      loggedIn: { graphqlClient },
+    } = await this.getContextAsync(SimulatorEvents, { nonInteractive });
+    await loadSimulatorEnvAsync(projectDir);
+    const deviceRunSessionId = flags.id ?? process.env[EAS_SIMULATOR_SESSION_ID];
+    if (!deviceRunSessionId) {
+      throw new Error(
+        `No simulator session ID provided. Pass --id, or run \`eas simulator:start\` first to write ${SIMULATOR_DOTENV_FILE_NAME}.`
+      );
+    }
+
+    const printedEventIds = new Set<string>();
+    let observedRunningSession = false;
+    let remainingPostStopRefreshes = 0;
+    let latestEvents: DeviceRunSessionEvent[] = [];
+    const abortController = new AbortController();
+    const { signal } = abortController;
+    const abortPromise = new Promise<void>(resolve => {
+      signal.addEventListener(
+        'abort',
+        () => {
+          resolve();
+        },
+        { once: true }
+      );
+    });
+    const interruptHandler = (): void => {
+      if (signal.aborted) {
+        process.exit(130);
+      }
+      abortController.abort();
+    };
+    if (flags.follow) {
+      process.on('SIGINT', interruptHandler);
+    }
+
+    try {
+      while (!signal.aborted) {
+        let session: DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId'];
+        let events: DeviceRunSessionEvent[];
+        try {
+          session = await DeviceRunSessionQuery.eventsByIdAsync(graphqlClient, deviceRunSessionId);
+          const eventArtifact = session.artifacts.find(
+            artifact => artifact.metadata?.__eas_type === 'session-events'
+          );
+          events = eventArtifact
+            ? await downloadDeviceRunSessionEventsAsync(eventArtifact.downloadUrl)
+            : [];
+        } catch (err) {
+          if (!flags.follow) {
+            throw err;
+          }
+          Log.debug(
+            `Failed to poll simulator session events: ${
+              err instanceof Error ? err.message : String(err)
+            }`
+          );
+          await Promise.race([sleepAsync(POLL_INTERVAL_MS), abortPromise]);
+          continue;
+        }
+        latestEvents = events;
+
+        if (jsonFlag) {
+          printJsonOnlyOutput({ deviceRunSessionId, events });
+          return;
+        }
+
+        const isRunning =
+          session.status === DeviceRunSessionStatus.New ||
+          session.status === DeviceRunSessionStatus.InProgress;
+        if (isRunning) {
+          observedRunningSession = true;
+          remainingPostStopRefreshes = 0;
+        } else if (observedRunningSession) {
+          observedRunningSession = false;
+          remainingPostStopRefreshes = POST_STOP_REFRESH_COUNT;
+        }
+
+        const shouldRefreshAgain =
+          flags.follow && !signal.aborted && (isRunning || remainingPostStopRefreshes > 0);
+        printNewEvents(events, printedEventIds, !shouldRefreshAgain);
+
+        if (!shouldRefreshAgain) {
+          if (events.length === 0) {
+            Log.log('No simulator session activity has been recorded.');
+          }
+          return;
+        }
+        if (!isRunning) {
+          remainingPostStopRefreshes -= 1;
+        }
+        await Promise.race([sleepAsync(POLL_INTERVAL_MS), abortPromise]);
+      }
+      printNewEvents(latestEvents, printedEventIds, true);
+    } finally {
+      if (flags.follow) {
+        process.removeListener('SIGINT', interruptHandler);
+      }
+    }
+  }
+}
+
+function printNewEvents(
+  events: DeviceRunSessionEvent[],
+  printedEventIds: Set<string>,
+  includeIncompleteOperations: boolean
+): void {
+  const displayEvents = projectDeviceRunSessionEventsForDisplay(events, {
+    includeIncompleteOperations,
+  });
+  for (const event of displayEvents) {
+    if (printedEventIds.has(event.eventId)) {
+      continue;
+    }
+    Log.log(formatDeviceRunSessionEvent(event));
+    printedEventIds.add(event.eventId);
+  }
+}
@@ -85,6 +85,7 @@ export default class SimulatorGet extends EasCommand {
    if (jsonFlag) {
      printJsonOnlyOutput({
        id: session.id,
+        name: session.name ?? undefined,
        type: deviceRunSessionTypeToFlagValue(session.type),
        status: session.status,
        platform: session.platform,
@@ -120,6 +121,7 @@ export default class SimulatorGet extends EasCommand {
 function formatSessionFields(session: DeviceRunSessionById, deviceRunSessionUrl: string): string {
  return formatFields([
    { label: 'ID', value: session.id },
+    { label: 'Name', value: formatNullable(session.name) },
    { label: 'Type', value: session.type },
    { label: 'Status', value: session.status },
    { label: 'Platform', value: session.platform },
@@ -131,6 +131,7 @@ export default class SimulatorList extends EasCommand {
      printJsonOnlyOutput({
        sessions: sessions.map(session => ({
          id: session.id,
+          name: session.name ?? undefined,
          type: deviceRunSessionTypeToFlagValue(session.type),
          status: session.status,
          platform: session.platform,
@@ -163,6 +164,7 @@ export default class SimulatorList extends EasCommand {
      );
      const lines = [
        `ID:       ${session.id}`,
+        `Name:     ${session.name ?? 'null'}`,
        `Type:     ${session.type}`,
        `Status:   ${session.status}`,
        `Platform: ${session.platform}`,
@@ -61,6 +61,10 @@ export default class SimulatorStart extends EasCommand {
      description: 'Device platform',
      options: PLATFORM_FLAG_VALUES,
    })(),
+    name: Flags.string({
+      description:
+        'Human-readable name for the simulator session, shown in eas simulator:list and on expo.dev. Defaults to unnamed.',
+    }),
    type: Flags.option({
      description: 'Type of simulator session to create',
      options: Object.values(DEVICE_RUN_SESSION_TYPE_FLAG_VALUES),
@@ -111,6 +115,10 @@ export default class SimulatorStart extends EasCommand {
      nonInteractive,
    });

+    // The server rejects blank names, so trim here and treat a whitespace-only
+    // --name as if it had been omitted rather than surfacing a validation error.
+    const name = flags.name?.trim() || undefined;
+
    await loadSimulatorEnvAsync(projectDir);
    const existingDeviceRunSessionId = process.env[EAS_SIMULATOR_SESSION_ID];
    if (existingDeviceRunSessionId && !flags.force) {
@@ -136,6 +144,7 @@ export default class SimulatorStart extends EasCommand {
    try {
      const session = await DeviceRunSessionMutation.createDeviceRunSessionAsync(graphqlClient, {
        appId: projectId,
+        name,
        platform,
        type: DEVICE_RUN_SESSION_TYPE_BY_FLAG_VALUE[flags.type],
        packageVersion: flags['package-version'],
@@ -224,6 +233,7 @@ export default class SimulatorStart extends EasCommand {
    if (jsonFlag) {
      printJsonOnlyOutput({
        id: deviceRunSessionId,
+        name,
        type: flags.type,
        deviceRunSessionUrl,
        remoteConfig,
@@ -2149,6 +2149,12 @@ export type AppObserve = {
  errorTimeSeries: AppObserveErrorTimeSeries;
  events: AppObserveEventsConnection;
  navigationRoutes: AppObserveNavigationRoutesConnection;
+  /** Active users and sessions for the Overview engagement band, across all versions. */
+  overviewEngagement: AppObserveOverviewEngagement;
+  /** Per-update comparison within one app version: the embedded bundle plus each OTA update. */
+  overviewUpdateComparison: AppObserveOverviewUpdateComparison;
+  /** Per-version, per-platform metric summaries for the Overview version-comparison matrix. */
+  overviewVersionComparison: AppObserveOverviewVersionComparison;
  timeSeries: AppObserveTimeSeries;
  totalEventCount: Scalars['Int']['output'];
  /**
@@ -2245,6 +2251,21 @@ export type AppObserveNavigationRoutesArgs = {
 };


+export type AppObserveOverviewEngagementArgs = {
+  input: AppObserveOverviewEngagementInput;
+};
+
+
+export type AppObserveOverviewUpdateComparisonArgs = {
+  input: AppObserveOverviewUpdateComparisonInput;
+};
+
+
+export type AppObserveOverviewVersionComparisonArgs = {
+  input: AppObserveOverviewVersionComparisonInput;
+};
+
+
 export type AppObserveTimeSeriesArgs = {
  input: AppObserveTimeSeriesInput;
 };
@@ -2810,6 +2831,132 @@ export type AppObserveNavigationStat = {
  p90?: Maybe<Scalars['Float']['output']>;
 };

+export type AppObserveOverviewEngagement = {
+  __typename?: 'AppObserveOverviewEngagement';
+  activeUsers: AppObserveOverviewEngagementStat;
+  sessions: AppObserveOverviewEngagementStat;
+};
+
+export type AppObserveOverviewEngagementBucket = {
+  __typename?: 'AppObserveOverviewEngagementBucket';
+  bucketStart: Scalars['DateTime']['output'];
+  count: Scalars['Int']['output'];
+};
+
+/** Engagement-band filters. No release filters: the band always spans all versions. */
+export type AppObserveOverviewEngagementInput = {
+  /** Series bucket size. Defaults to one day. */
+  bucketIntervalMinutes?: InputMaybe<Scalars['Int']['input']>;
+  endTime: Scalars['DateTime']['input'];
+  environment?: InputMaybe<Scalars['String']['input']>;
+  platform?: InputMaybe<AppObservePlatform>;
+  startTime: Scalars['DateTime']['input'];
+};
+
+export type AppObserveOverviewEngagementStat = {
+  __typename?: 'AppObserveOverviewEngagementStat';
+  previousPeriodTotal: Scalars['Int']['output'];
+  /** Per-bucket approximate uniques; buckets do not sum to `total`. */
+  series: Array<AppObserveOverviewEngagementBucket>;
+  total: Scalars['Int']['output'];
+};
+
+export type AppObserveOverviewStability = {
+  __typename?: 'AppObserveOverviewStability';
+  affectedUsers: Scalars['Int']['output'];
+  /** Fraction (0..1) of active sessions without a fatal error. */
+  crashFreeSessions: Scalars['Float']['output'];
+  /** Fraction (0..1) of active users without a fatal error. */
+  crashFreeUsers: Scalars['Float']['output'];
+  totalErrors: Scalars['Int']['output'];
+};
+
+export type AppObserveOverviewUpdate = {
+  __typename?: 'AppObserveOverviewUpdate';
+  /** Null for the embedded bundle. */
+  appUpdateId?: Maybe<Scalars['ID']['output']>;
+  /** Downloads recorded in range; null when none were recorded (and always for the embedded bundle). */
+  downloadCount?: Maybe<Scalars['Int']['output']>;
+  eventCount: Scalars['Int']['output'];
+  firstSeenAt: Scalars['DateTime']['output'];
+  isEmbedded: Scalars['Boolean']['output'];
+  medianDownloadTime?: Maybe<Scalars['Float']['output']>;
+  /** EAS update message; null for the embedded bundle or when the update row no longer exists. */
+  message?: Maybe<Scalars['String']['output']>;
+  /** One entry per metric with data in range, all platforms combined. */
+  metrics: Array<AppObserveOverviewUpdateMetric>;
+  /** When the update was published; null for the embedded bundle. */
+  publishedAt?: Maybe<Scalars['DateTime']['output']>;
+  stability: AppObserveOverviewStability;
+  uniqueUserCount: Scalars['Int']['output'];
+};
+
+export type AppObserveOverviewUpdateComparison = {
+  __typename?: 'AppObserveOverviewUpdateComparison';
+  /** Embedded bundle first, then OTA updates oldest first. Only updates with runtime data appear. */
+  updates: Array<AppObserveOverviewUpdate>;
+};
+
+export type AppObserveOverviewUpdateComparisonInput = {
+  appVersion: Scalars['String']['input'];
+  endTime: Scalars['DateTime']['input'];
+  environment?: InputMaybe<Scalars['String']['input']>;
+  /** Metric names to aggregate. Defaults to all metrics available on the account's plan. */
+  metricNames?: InputMaybe<Array<Scalars['String']['input']>>;
+  startTime: Scalars['DateTime']['input'];
+};
+
+export type AppObserveOverviewUpdateMetric = {
+  __typename?: 'AppObserveOverviewUpdateMetric';
+  eventCount: Scalars['Int']['output'];
+  metricName: Scalars['String']['output'];
+  statistics: AppObserveVersionMarkerStatistics;
+};
+
+export type AppObserveOverviewVersion = {
+  __typename?: 'AppObserveOverviewVersion';
+  appVersion: Scalars['String']['output'];
+  firstSeenAt: Scalars['DateTime']['output'];
+  /** One entry per (metric, platform) with data in range; iOS includes tvOS and iPadOS. */
+  metrics: Array<AppObserveOverviewVersionMetric>;
+  /** Error stats for this version, all platforms combined. */
+  stability: AppObserveOverviewStability;
+  uniqueUserCount: Scalars['Int']['output'];
+};
+
+export type AppObserveOverviewVersionComparison = {
+  __typename?: 'AppObserveOverviewVersionComparison';
+  /** Every version with data in range, highest version first, for the version picker. */
+  allVersions: Array<AppObserveOverviewVersionSummary>;
+  /** Compared versions, lowest version first. Requested versions with no data are omitted. */
+  versions: Array<AppObserveOverviewVersion>;
+};
+
+export type AppObserveOverviewVersionComparisonInput = {
+  /** Versions to compare (max 10, any order). Defaults to the three highest versions. */
+  appVersions?: InputMaybe<Array<Scalars['String']['input']>>;
+  endTime: Scalars['DateTime']['input'];
+  environment?: InputMaybe<Scalars['String']['input']>;
+  /** Metric names to aggregate. Defaults to all metrics available on the account's plan. */
+  metricNames?: InputMaybe<Array<Scalars['String']['input']>>;
+  startTime: Scalars['DateTime']['input'];
+};
+
+export type AppObserveOverviewVersionMetric = {
+  __typename?: 'AppObserveOverviewVersionMetric';
+  eventCount: Scalars['Int']['output'];
+  metricName: Scalars['String']['output'];
+  platform: AppObservePlatform;
+  statistics: AppObserveVersionMarkerStatistics;
+};
+
+export type AppObserveOverviewVersionSummary = {
+  __typename?: 'AppObserveOverviewVersionSummary';
+  appVersion: Scalars['String']['output'];
+  firstSeenAt: Scalars['DateTime']['output'];
+  uniqueUserCount: Scalars['Int']['output'];
+};
+
 export enum AppObservePlatform {
  Android = 'ANDROID',
  Ios = 'IOS'
@@ -4933,6 +5080,11 @@ export type CreateDeviceRunSessionInput = {
   * plans. If omitted, the default is derived based on the job run's priority.
   */
  maxRunTimeMinutes?: InputMaybe<Scalars['Int']['input']>;
+  /**
+   * Human-readable label for the session, at most 255 characters. If omitted, the
+   * session is unnamed and clients fall back to identifying it by id.
+   */
+  name?: InputMaybe<Scalars['String']['input']>;
  /**
   * The version of the package backing the device run session (e.g. "0.1.3-alpha.3").
   * If omitted, consumers treat the session as pinned to "latest".
@@ -5689,6 +5841,11 @@ export type DeviceRunSession = {
  finishedAt?: Maybe<Scalars['DateTime']['output']>;
  id: Scalars['ID']['output'];
  initiatingActor?: Maybe<Actor>;
+  /**
+   * Human-readable label chosen by whoever started the session. Null when the
+   * session was started without one.
+   */
+  name?: Maybe<Scalars['String']['output']>;
  /**
   * The version of the package backing the device run session. Null means the session is
   * pinned to "latest" at the consumer side.
@@ -10746,6 +10903,11 @@ export type User = Actor & UserActor & {
  lastName?: Maybe<Scalars['String']['output']>;
  newEmailPendingVerification?: Maybe<Scalars['String']['output']>;
  oAuthIdentities: Array<OAuthIdentity>;
+  /**
+   * The organization created during signup onboarding: the most recently
+   * created organization this user owns. Only resolves for the viewer.
+   */
+  onboardingOrganization?: Maybe<Account>;
  /** Registered passkey credentials */
  passkeyCredentials: Array<UserPasskeyCredential>;
  /** Pending UserInvitations for this user. Only resolves for the viewer. */
@@ -14415,12 +14577,19 @@ export type SimulatorAvailabilityQueryVariables = Exact<{

 export type SimulatorAvailabilityQuery = { __typename?: 'RootQuery', app: { __typename?: 'AppQuery', byId: { __typename?: 'App', id: string, ownerAccount: { __typename?: 'Account', id: string, name: string, accountFeatureGates: any } } } };

+export type DeviceRunSessionEventsByIdQueryVariables = Exact<{
+  deviceRunSessionId: Scalars['ID']['input'];
+}>;
+
+
+export type DeviceRunSessionEventsByIdQuery = { __typename?: 'RootQuery', deviceRunSessions: { __typename?: 'DeviceRunSessionQuery', byId: { __typename?: 'DeviceRunSession', id: string, status: DeviceRunSessionStatus, artifacts: Array<{ __typename?: 'DeviceRunSessionArtifact', id: string, downloadUrl: string, metadata?: any | null }> } } };
+
 export type DeviceRunSessionByIdQueryVariables = Exact<{
  deviceRunSessionId: Scalars['ID']['input'];
 }>;


-export type DeviceRunSessionByIdQuery = { __typename?: 'RootQuery', deviceRunSessions: { __typename?: 'DeviceRunSessionQuery', byId: { __typename?: 'DeviceRunSession', id: string, status: DeviceRunSessionStatus, type: DeviceRunSessionType, platform: AppPlatform, createdAt: any, startedAt?: any | null, finishedAt?: any | null, updatedAt: any, app: { __typename?: 'App', id: string, slug: string, ownerAccount: { __typename?: 'Account', id: string, name: string } }, artifacts: Array<{ __typename?: 'DeviceRunSessionArtifact', id: string, name: string, filename: string, downloadUrl: string, fileSizeBytes?: number | null, metadata?: any | null, createdAt: any, updatedAt: any }>, remoteConfig?:
+export type DeviceRunSessionByIdQuery = { __typename?: 'RootQuery', deviceRunSessions: { __typename?: 'DeviceRunSessionQuery', byId: { __typename?: 'DeviceRunSession', id: string, name?: string | null, status: DeviceRunSessionStatus, type: DeviceRunSessionType, platform: AppPlatform, createdAt: any, startedAt?: any | null, finishedAt?: any | null, updatedAt: any, app: { __typename?: 'App', id: string, slug: string, ownerAccount: { __typename?: 'Account', id: string, name: string } }, artifacts: Array<{ __typename?: 'DeviceRunSessionArtifact', id: string, name: string, filename: string, downloadUrl: string, fileSizeBytes?: number | null, metadata?: any | null, createdAt: any, updatedAt: any }>, remoteConfig?:
        | { __typename: 'AgentDeviceRunSessionRemoteConfig', agentDeviceRemoteSessionUrl: string, agentDeviceRemoteSessionToken: string, webPreviewUrl?: string | null }
        | { __typename: 'ArgentRunSessionRemoteConfig', toolsUrl: string, toolsAuthToken?: string | null, webPreviewUrl?: string | null }
        | { __typename: 'ServeSimRunSessionRemoteConfig', previewUrl: string }
@@ -14434,7 +14603,7 @@ export type DeviceRunSessionsByAppIdQueryVariables = Exact<{
 }>;


-export type DeviceRunSessionsByAppIdQuery = { __typename?: 'RootQuery', app: { __typename?: 'AppQuery', byId: { __typename?: 'App', id: string, deviceRunSessionsPaginated: { __typename?: 'AppDeviceRunSessionsConnection', edges: Array<{ __typename?: 'AppDeviceRunSessionEdge', cursor: string, node: { __typename?: 'DeviceRunSession', id: string, status: DeviceRunSessionStatus, type: DeviceRunSessionType, platform: AppPlatform, createdAt: any, startedAt?: any | null, finishedAt?: any | null, app: { __typename?: 'App', id: string, slug: string, ownerAccount: { __typename?: 'Account', id: string, name: string } }, turtleJobRun?: { __typename?: 'JobRun', id: string, status: JobRunStatus } | null } }>, pageInfo: { __typename?: 'PageInfo', hasNextPage: boolean, hasPreviousPage: boolean, startCursor?: string | null, endCursor?: string | null } } } } };
+export type DeviceRunSessionsByAppIdQuery = { __typename?: 'RootQuery', app: { __typename?: 'AppQuery', byId: { __typename?: 'App', id: string, deviceRunSessionsPaginated: { __typename?: 'AppDeviceRunSessionsConnection', edges: Array<{ __typename?: 'AppDeviceRunSessionEdge', cursor: string, node: { __typename?: 'DeviceRunSession', id: string, name?: string | null, status: DeviceRunSessionStatus, type: DeviceRunSessionType, platform: AppPlatform, createdAt: any, startedAt?: any | null, finishedAt?: any | null, app: { __typename?: 'App', id: string, slug: string, ownerAccount: { __typename?: 'Account', id: string, name: string } }, turtleJobRun?: { __typename?: 'JobRun', id: string, status: JobRunStatus } | null } }>, pageInfo: { __typename?: 'PageInfo', hasNextPage: boolean, hasPreviousPage: boolean, startCursor?: string | null, endCursor?: string | null } } } } };

 export type ViewEmbeddedUpdateByIdQueryVariables = Exact<{
  embeddedUpdateId: Scalars['ID']['input'];
@@ -5,12 +5,43 @@ import { withErrorHandlingAsync } from '../client';
 import {
  DeviceRunSessionByIdQuery,
  DeviceRunSessionByIdQueryVariables,
+  DeviceRunSessionEventsByIdQuery,
+  DeviceRunSessionEventsByIdQueryVariables,
  DeviceRunSessionFilterInput,
  DeviceRunSessionsByAppIdQuery,
  DeviceRunSessionsByAppIdQueryVariables,
 } from '../generated';

 export const DeviceRunSessionQuery = {
+  async eventsByIdAsync(
+    graphqlClient: ExpoGraphqlClient,
+    deviceRunSessionId: string
+  ): Promise<DeviceRunSessionEventsByIdQuery['deviceRunSessions']['byId']> {
+    const data = await withErrorHandlingAsync(
+      graphqlClient
+        .query<DeviceRunSessionEventsByIdQuery, DeviceRunSessionEventsByIdQueryVariables>(
+          gql`
+            query DeviceRunSessionEventsByIdQuery($deviceRunSessionId: ID!) {
+              deviceRunSessions {
+                byId(deviceRunSessionId: $deviceRunSessionId) {
+                  id
+                  status
+                  artifacts {
+                    id
+                    downloadUrl
+                    metadata
+                  }
+                }
+              }
+            }
+          `,
+          { deviceRunSessionId },
+          { requestPolicy: 'network-only' }
+        )
+        .toPromise()
+    );
+    return data.deviceRunSessions.byId;
+  },
  async byIdAsync(
    graphqlClient: ExpoGraphqlClient,
    deviceRunSessionId: string
@@ -23,6 +54,7 @@ export const DeviceRunSessionQuery = {
              deviceRunSessions {
                byId(deviceRunSessionId: $deviceRunSessionId) {
                  id
+                  name
                  status
                  type
                  platform
@@ -111,6 +143,7 @@ export const DeviceRunSessionQuery = {
                      cursor
                      node {
                        id
+                        name
                        status
                        type
                        platform
@@ -0,0 +1,198 @@
+import fetch, { RequestError, Response } from '../../fetch';
+import {
+  type DeviceRunSessionEvent,
+  downloadDeviceRunSessionEventsAsync,
+  formatDeviceRunSessionEvent,
+  projectDeviceRunSessionEventsForDisplay,
+} from '../events';
+
+jest.mock('../../fetch', () => ({
+  __esModule: true,
+  ...jest.requireActual('../../fetch'),
+  default: jest.fn(),
+}));
+
+describe(projectDeviceRunSessionEventsForDisplay, () => {
+  it('collapses completed operations and carries duration onto the recorded interaction', () => {
+    const events = [
+      createEventValue({
+        eventId: 'started',
+        type: 'operation.started',
+        operationId: 'operation-id',
+        summary: 'Started press',
+      }),
+      createEventValue({
+        eventId: 'interaction',
+        ts: '2026-07-10T12:00:01.000Z',
+        type: 'interaction.recorded',
+        operationId: 'operation-id',
+        summary: 'Tapped @e13',
+      }),
+      createEventValue({
+        eventId: 'completed',
+        ts: '2026-07-10T12:00:02.000Z',
+        type: 'operation.completed',
+        operationId: 'operation-id',
+        outcome: 'success',
+        durationMs: 123,
+        summary: 'Finished press',
+      }),
+    ];
+
+    expect(projectDeviceRunSessionEventsForDisplay(events)).toEqual([
+      {
+        ...events[1],
+        durationMs: 123,
+        outcome: 'success',
+      },
+    ]);
+  });
+
+  it('preserves completed failures and successful operations without interactions', () => {
+    const successful = createEventValue({
+      eventId: 'successful',
+      type: 'operation.completed',
+      operationId: 'successful-operation',
+      outcome: 'success',
+      summary: 'Found 2 devices',
+    });
+    const failed = createEventValue({
+      eventId: 'failed',
+      ts: '2026-07-10T12:00:01.000Z',
+      type: 'operation.completed',
+      operationId: 'failed-operation',
+      outcome: 'failure',
+      summary: 'Failed install: INVALID_ARGS',
+    });
+
+    expect(projectDeviceRunSessionEventsForDisplay([successful, failed])).toEqual([
+      successful,
+      failed,
+    ]);
+  });
+
+  it('can withhold incomplete operations while following a running session', () => {
+    const started = createEventValue({
+      eventId: 'started',
+      type: 'operation.started',
+      operationId: 'operation-id',
+      summary: 'Started install',
+    });
+    const interaction = createEventValue({
+      eventId: 'interaction',
+      type: 'interaction.recorded',
+      operationId: 'another-operation-id',
+      summary: 'Captured screenshot screenshot.png',
+    });
+    const standalone = createEventValue({
+      eventId: 'standalone',
+      type: 'control.recorded',
+      summary: 'Stopping session',
+    });
+
+    expect(
+      projectDeviceRunSessionEventsForDisplay([started, interaction, standalone], {
+        includeIncompleteOperations: false,
+      })
+    ).toEqual([standalone]);
+    expect(projectDeviceRunSessionEventsForDisplay([started, interaction, standalone])).toEqual([
+      started,
+      interaction,
+      standalone,
+    ]);
+  });
+
+  it('keeps matching operation IDs from different producers separate', () => {
+    const agentStarted = createEventValue({
+      eventId: 'agent-started',
+      operationId: 'shared-operation-id',
+      summary: 'Started devices',
+    });
+    const agentCompleted = createEventValue({
+      eventId: 'agent-completed',
+      type: 'operation.completed',
+      operationId: 'shared-operation-id',
+      outcome: 'success',
+      summary: 'Found 2 devices',
+    });
+    const serveSimStarted = createEventValue({
+      eventId: 'serve-sim-started',
+      producer: 'serve-sim',
+      operationId: 'shared-operation-id',
+      summary: 'Started simulator activity',
+    });
+
+    expect(
+      projectDeviceRunSessionEventsForDisplay([agentStarted, agentCompleted, serveSimStarted]).map(
+        ({ eventId }) => eventId
+      )
+    ).toEqual(['agent-completed', 'serve-sim-started']);
+  });
+});
+
+describe(formatDeviceRunSessionEvent, () => {
+  it('formats a compact log line with the producer and duration', () => {
+    expect(
+      formatDeviceRunSessionEvent(
+        createEventValue({
+          ts: '2026-07-10T12:00:01.000Z',
+          summary: 'Found 2 devices',
+          durationMs: 123,
+        })
+      )
+    ).toBe('2026-07-10T12:00:01.000Z  [agent-device] Found 2 devices (123ms)');
+  });
+
+  it('includes a screenshot filename without exposing its full path', () => {
+    expect(
+      formatDeviceRunSessionEvent(
+        createEventValue({
+          summary: 'Ran screenshot',
+          data: {
+            command: 'screenshot',
+            path: '/tmp/private/screenshot.png',
+          },
+        })
+      )
+    ).toBe('2026-07-10T12:00:00.000Z  [agent-device] Ran screenshot screenshot.png');
+  });
+
+  it('strips ANSI escape sequences and control characters from terminal output', () => {
+    expect(
+      formatDeviceRunSessionEvent(
+        createEventValue({
+          ts: '\u001B[31m2026-07-10T12:00:00.000Z\u001B[0m\n',
+          producer: 'agent\u0000-device',
+          summary: 'Found\r2\tdevices\u0007',
+        })
+      )
+    ).toBe('2026-07-10T12:00:00.000Z  [agent-device] Found2devices');
+  });
+});
+
+describe(downloadDeviceRunSessionEventsAsync, () => {
+  beforeEach(() => {
+    jest.mocked(fetch).mockReset();
+  });
+
+  it('treats a missing event object as an empty log', async () => {
+    const response = new Response('', { status: 404 });
+    jest.mocked(fetch).mockRejectedValue(new RequestError('not found', response));
+
+    await expect(
+      downloadDeviceRunSessionEventsAsync('https://example.test/events')
+    ).resolves.toEqual([]);
+  });
+});
+
+function createEventValue(overrides: Partial<DeviceRunSessionEvent> = {}): DeviceRunSessionEvent {
+  return {
+    v: 1,
+    eventId: 'event-id',
+    ts: '2026-07-10T12:00:00.000Z',
+    producer: 'agent-device',
+    type: 'operation.started',
+    summary: 'Started tap',
+    ...overrides,
+  };
+}
@@ -0,0 +1,120 @@
+import { stripVTControlCharacters } from 'util';
+
+import { type DeviceRunSessionEvent, parseDeviceRunSessionEvents } from '@expo/eas-build-job';
+
+import fetch, { RequestError } from '../fetch';
+import { formatMilliseconds } from '../utils/timer';
+
+export type { DeviceRunSessionEvent };
+
+export async function downloadDeviceRunSessionEventsAsync(
+  eventLogUrl: string
+): Promise<DeviceRunSessionEvent[]> {
+  try {
+    const response = await fetch(eventLogUrl);
+    return parseDeviceRunSessionEvents(await response.text());
+  } catch (error) {
+    if (error instanceof RequestError && error.response.status === 404) {
+      return [];
+    }
+    throw error;
+  }
+}
+
+export function projectDeviceRunSessionEventsForDisplay(
+  events: DeviceRunSessionEvent[],
+  { includeIncompleteOperations = true }: { includeIncompleteOperations?: boolean } = {}
+): DeviceRunSessionEvent[] {
+  const operations = new Map<
+    string,
+    {
+      completed?: DeviceRunSessionEvent;
+      interactions: DeviceRunSessionEvent[];
+    }
+  >();
+
+  for (const event of events) {
+    if (!event.operationId) {
+      continue;
+    }
+    const operationKey = getOperationKey(event);
+    const operation = operations.get(operationKey) ?? { interactions: [] };
+    if (event.type === 'operation.completed') {
+      operation.completed = event;
+    } else if (event.type === 'interaction.recorded') {
+      operation.interactions.push(event);
+    }
+    operations.set(operationKey, operation);
+  }
+
+  return events.flatMap(event => {
+    if (!event.operationId) {
+      return [event];
+    }
+
+    const operation = operations.get(getOperationKey(event));
+    const completed = operation?.completed;
+    const interactions = operation?.interactions ?? [];
+
+    if (
+      !includeIncompleteOperations &&
+      !completed &&
+      (event.type === 'operation.started' || event.type === 'interaction.recorded')
+    ) {
+      return [];
+    }
+    if (event.type === 'operation.started' && (completed || interactions.length > 0)) {
+      return [];
+    }
+    if (event.type === 'interaction.recorded' && completed?.outcome === 'failure') {
+      return [];
+    }
+    if (event.type === 'operation.completed' && completed?.outcome !== 'failure') {
+      return interactions.length > 0 ? [] : [event];
+    }
+    if (
+      event.type === 'interaction.recorded' &&
+      completed &&
+      interactions.at(-1)?.eventId === event.eventId
+    ) {
+      return [{ ...event, durationMs: completed.durationMs, outcome: completed.outcome }];
+    }
+
+    return [event];
+  });
+}
+
+export function formatDeviceRunSessionEvent(event: DeviceRunSessionEvent): string {
+  const screenshotFilename = getScreenshotFilename(event);
+  const summary =
+    screenshotFilename && !event.summary.includes(screenshotFilename)
+      ? `${event.summary} ${screenshotFilename}`
+      : event.summary;
+  const duration =
+    event.durationMs === undefined ? '' : ` (${formatEventDuration(event.durationMs)})`;
+  return stripTerminalControlCharacters(`${event.ts}  [${event.producer}] ${summary}${duration}`);
+}
+
+function getOperationKey(event: DeviceRunSessionEvent): string {
+  return JSON.stringify([event.producer, event.operationId]);
+}
+
+function formatEventDuration(durationMs: number): string {
+  return durationMs < 1000 ? `${Math.round(durationMs)}ms` : formatMilliseconds(durationMs);
+}
+
+function getScreenshotFilename(event: DeviceRunSessionEvent): string | undefined {
+  if (event.data?.command !== 'screenshot' || typeof event.data.path !== 'string') {
+    return undefined;
+  }
+  return event.data.path.split(/[\\/]/).at(-1);
+}
+
+function stripTerminalControlCharacters(value: string): string {
+  return [...stripVTControlCharacters(value)]
+    .filter(character => {
+      const codePoint = character.codePointAt(0) ?? 0;
+      return codePoint >= 0x20 && !(codePoint >= 0x7f && codePoint <= 0x9f);
+    })
+    .join('');
+}
@@ -54,7 +54,7 @@ export function formatRemoteSessionInstructions(
          ? [
              '🔑 Run the following to use agent-device with the simulator:',
              '',
-              'eas simulator:exec agent-device <command>',
+              'eas simulator:exec npx agent-device <command>',
            ]
          : [
              '🔑 Run the following in your shell to attach to the agent-device daemon:',
@@ -1,6 +1,6 @@
 {
  "name": "@expo/eas-json",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "description": "A library for interacting with eas.json",
  "homepage": "https://github.com/expo/eas-cli",
  "bugs": "https://github.com/expo/eas-cli/issues",
@@ -32,7 +32,7 @@
  },
  "dependencies": {
    "@babel/code-frame": "7.23.5",
-    "@expo/eas-build-job": "21.3.0",
+    "@expo/eas-build-job": "21.4.0",
    "chalk": "4.1.2",
    "env-string": "1.0.1",
    "fs-extra": "11.2.0",
@@ -1,6 +1,6 @@
 {
  "name": "eas-cli-local-build-plugin",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "description": "Tool for running EAS compatible builds on a local machine.",
  "bugs": "https://github.com/expo/eas-cli/issues",
  "license": "BUSL-1.1",
@@ -26,8 +26,8 @@
    "clean": "rimraf node_modules dist coverage \"*.tsbuildinfo\""
  },
  "dependencies": {
-    "@expo/build-tools": "21.3.0",
-    "@expo/eas-build-job": "21.3.0",
+    "@expo/build-tools": "21.4.0",
+    "@expo/eas-build-job": "21.4.0",
    "@expo/logger": "21.0.0",
    "@expo/spawn-async": "^1.7.2",
    "@expo/turtle-spawn": "21.0.0",
@@ -1,6 +1,6 @@
 {
  "name": "@expo/steps",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "bugs": "https://github.com/expo/eas-cli/issues",
  "license": "BUSL-1.1",
  "author": "Expo <[email protected]>",
@@ -27,7 +27,7 @@
    "clean": "rimraf node_modules dist coverage \"*.tsbuildinfo\""
  },
  "dependencies": {
-    "@expo/eas-build-job": "21.3.0",
+    "@expo/eas-build-job": "21.4.0",
    "@expo/logger": "21.0.0",
    "@expo/spawn-async": "^1.7.2",
    "arg": "^5.0.2",
@@ -1,6 +1,6 @@
 {
  "name": "@expo/worker",
-  "version": "21.3.0",
+  "version": "21.4.0",
  "private": true,
  "scripts": {
    "start": "yarn watch",
@@ -19,16 +19,16 @@
  },
  "dependencies": {
    "@babel/core": "7.24.7",
-    "@expo/build-tools": "21.3.0",
+    "@expo/build-tools": "21.4.0",
    "@expo/config-plugins": "55.0.7",
    "@expo/config-types": "55.0.5",
    "@expo/downloader": "21.0.0",
-    "@expo/eas-build-job": "21.3.0",
+    "@expo/eas-build-job": "21.4.0",
    "@expo/logger": "21.0.0",
    "@expo/results": "1.0.0",
    "@expo/rudder-sdk-node": "1.1.1",
    "@expo/spawn-async": "1.7.2",
-    "@expo/steps": "21.3.0",
+    "@expo/steps": "21.4.0",
    "@expo/template-file": "21.0.2",
    "@expo/turtle-spawn": "21.0.0",
    "@hapi/boom": "10.0.1",
@@ -2291,14 +2291,14 @@ __metadata:
  languageName: node
  linkType: hard

-"@expo/build-tools@npm:21.3.0, @expo/build-tools@workspace:packages/build-tools":
+"@expo/build-tools@npm:21.4.0, @expo/build-tools@workspace:packages/build-tools":
  version: 0.0.0-use.local
  resolution: "@expo/build-tools@workspace:packages/build-tools"
  dependencies:
    "@expo/config": "npm:55.0.10"
    "@expo/config-plugins": "npm:55.0.7"
    "@expo/downloader": "npm:21.0.0"
-    "@expo/eas-build-job": "npm:21.3.0"
+    "@expo/eas-build-job": "npm:21.4.0"
    "@expo/env": "npm:^0.4.0"
    "@expo/logger": "npm:21.0.0"
    "@expo/package-manager": "npm:1.9.10"
@@ -2306,7 +2306,7 @@ __metadata:
    "@expo/repack-app": "npm:~0.6.1"
    "@expo/results": "npm:^1.0.0"
    "@expo/spawn-async": "npm:1.7.2"
-    "@expo/steps": "npm:21.3.0"
+    "@expo/steps": "npm:21.4.0"
    "@expo/template-file": "npm:21.0.2"
    "@expo/turtle-spawn": "npm:21.0.0"
    "@expo/xcpretty": "npm:^4.3.1"
@@ -2547,7 +2547,7 @@ __metadata:
  languageName: unknown
  linkType: soft

-"@expo/eas-build-job@npm:21.3.0, @expo/eas-build-job@workspace:packages/eas-build-job":
+"@expo/eas-build-job@npm:21.4.0, @expo/eas-build-job@workspace:packages/eas-build-job":
  version: 0.0.0-use.local
  resolution: "@expo/eas-build-job@workspace:packages/eas-build-job"
  dependencies:
@@ -2566,12 +2566,12 @@ __metadata:
  languageName: unknown
  linkType: soft

-"@expo/eas-json@npm:21.3.0, @expo/eas-json@workspace:packages/eas-json":
+"@expo/eas-json@npm:21.4.0, @expo/eas-json@workspace:packages/eas-json":
  version: 0.0.0-use.local
  resolution: "@expo/eas-json@workspace:packages/eas-json"
  dependencies:
    "@babel/code-frame": "npm:7.23.5"
-    "@expo/eas-build-job": "npm:21.3.0"
+    "@expo/eas-build-job": "npm:21.4.0"
    "@tsconfig/node20": "npm:20.1.8"
    "@types/babel__code-frame": "npm:7.0.3"
    "@types/fs-extra": "npm:11.0.4"
@@ -2884,11 +2884,11 @@ __metadata:
  languageName: node
  linkType: hard

-"@expo/steps@npm:21.3.0, @expo/steps@workspace:packages/steps":
+"@expo/steps@npm:21.4.0, @expo/steps@workspace:packages/steps":
  version: 0.0.0-use.local
  resolution: "@expo/steps@workspace:packages/steps"
  dependencies:
-    "@expo/eas-build-job": "npm:21.3.0"
+    "@expo/eas-build-job": "npm:21.4.0"
    "@expo/logger": "npm:21.0.0"
    "@expo/spawn-async": "npm:^1.7.2"
    "@jest/globals": "npm:^29.7.0"
@@ -2957,16 +2957,16 @@ __metadata:
  resolution: "@expo/worker@workspace:packages/worker"
  dependencies:
    "@babel/core": "npm:7.24.7"
-    "@expo/build-tools": "npm:21.3.0"
+    "@expo/build-tools": "npm:21.4.0"
    "@expo/config-plugins": "npm:55.0.7"
    "@expo/config-types": "npm:55.0.5"
    "@expo/downloader": "npm:21.0.0"
-    "@expo/eas-build-job": "npm:21.3.0"
+    "@expo/eas-build-job": "npm:21.4.0"
    "@expo/logger": "npm:21.0.0"
    "@expo/results": "npm:1.0.0"
    "@expo/rudder-sdk-node": "npm:1.1.1"
    "@expo/spawn-async": "npm:1.7.2"
-    "@expo/steps": "npm:21.3.0"
+    "@expo/steps": "npm:21.4.0"
    "@expo/template-file": "npm:21.0.2"
    "@expo/turtle-spawn": "npm:21.0.0"
    "@hapi/boom": "npm:10.0.1"
@@ -9722,7 +9722,7 @@ __metadata:
  resolution: "create-eas-build-function@workspace:packages/create-eas-build-function"
  dependencies:
    "@expo/package-manager": "npm:1.9.10"
-    "@expo/steps": "npm:21.3.0"
+    "@expo/steps": "npm:21.4.0"
    "@jest/globals": "npm:^29.7.0"
    "@types/jest": "npm:^29.5.12"
    "@types/node": "npm:20.14.2"
@@ -10294,8 +10294,8 @@ __metadata:
  version: 0.0.0-use.local
  resolution: "eas-cli-local-build-plugin@workspace:packages/local-build-plugin"
  dependencies:
-    "@expo/build-tools": "npm:21.3.0"
-    "@expo/eas-build-job": "npm:21.3.0"
+    "@expo/build-tools": "npm:21.4.0"
+    "@expo/eas-build-job": "npm:21.4.0"
    "@expo/logger": "npm:21.0.0"
    "@expo/spawn-async": "npm:^1.7.2"
    "@expo/turtle-spawn": "npm:21.0.0"
@@ -10352,8 +10352,8 @@ __metadata:
    "@expo/code-signing-certificates": "npm:0.0.5"
    "@expo/config": "npm:55.0.10"
    "@expo/config-plugins": "npm:55.0.7"
-    "@expo/eas-build-job": "npm:21.3.0"
-    "@expo/eas-json": "npm:21.3.0"
+    "@expo/eas-build-job": "npm:21.4.0"
+    "@expo/eas-json": "npm:21.4.0"
    "@expo/env": "npm:^1.0.0"
    "@expo/json-file": "npm:8.3.3"
    "@expo/logger": "npm:21.0.0"
@@ -10368,7 +10368,7 @@ __metadata:
    "@expo/results": "npm:1.0.0"
    "@expo/rudder-sdk-node": "npm:1.1.1"
    "@expo/spawn-async": "npm:1.7.2"
-    "@expo/steps": "npm:21.3.0"
+    "@expo/steps": "npm:21.4.0"
    "@expo/timeago.js": "npm:1.0.0"
    "@graphql-codegen/cli": "npm:6.3.1"
    "@graphql-codegen/introspection": "npm:5.0.2"
Author	SHA1	Message	Date
Expo CI	dcc7201ca8	v21.4.0	2026-07-28 10:18:26 +00:00
Szymon Dziedzic	bf3f259bc4	[eas-cli] Support naming simulator sessions (#4099 ) * [eas-cli] Support naming simulator sessions * [eas-cli] Trim the simulator session name flag	2026-07-28 12:14:06 +02:00
Szymon DziedzicandClaude Opus 4.8	1a573679e5	[eas-cli] Add simulator session activity command (#4001 ) * [eas-cli] Add simulator session activity command * [eas-cli] Read simulator events from artifacts * [eas-cli] Read session event artifact type metadata * [eas-cli] Read compact session event records * [eas-cli] Align simulator event output * [eas-cli] Harden simulator event following * [eas-build-job] Share device run session event schema Move the DeviceRunSession session-events record schema, type, and NDJSON parser out of eas-cli into @expo/eas-build-job so producers (worker, agent-device) and consumers (eas-cli, website) share a single source of truth for the wire format. eas-cli re-exports the type and keeps the CLI-only display, formatting, and download logic. Co-Authored-By: Claude Opus 4.8 <[email protected]> * [eas-cli] Regenerate GraphQL schema and types Run `yarn generate-graphql-code` to refresh the committed schema snapshot and generated types against the current API. Co-Authored-By: Claude Opus 4.8 <[email protected]> --------- Co-authored-by: Claude Opus 4.8 <[email protected]>	2026-07-28 11:10:02 +02:00
Douglas Lowder	bb589f1d36	[eas-cli] Apply --session-id in observe:events summary mode (#4100 ) # Summary Without an event name, observe:events showed the account-wide event-name summary, which has no session filter, so --session-id was ignored. When a session ID is given, take the events-list path (like --all-events) so the session's events are shown filtered by the customEventList session filter. # Test Plan - New unit tests added - Manual testing against a production project	2026-07-27 18:25:17 -07:00
Szymon DziedzicandClaude Opus 4.8	83b86b8ee6	[build-tools] Collect Argent tool-server session events during remote sessions (#4067 ) * [build-tools] Collect Argent tool-server session events during remote sessions Argent's tool-server writes a structured event log (bunyan JSONL at ~/.argent/tool-server-events.jsonl) when the `tool-server-event-log` flag is on (@swmansion/argent >= 0.16.0). Tail it during remote simulator sessions and upload normalized events to the API server, mirroring agent-device. - Extract the file-tailing/upload/poll machinery from deviceRunSessionEvents.ts into a generic, producer-parameterized engine; move the agent-device adapter into agentDeviceEvents.ts (matching the deviceRunSessionArtifacts/Artifacts split). - Add argentEvents.ts: maps tool.invoked/completed/failed onto the shared operation. vocabulary and passes other record types through unchanged. - Enable the event log flag best-effort so older pinned Argent versions (where the flag does not exist) keep working without event collection. Co-Authored-By: Claude Opus 4.8 <[email protected]> * [build-tools] Require @swmansion/argent >= 0.16.0 and enable event log unconditionally Bump MIN_ARGENT_REMOTE_SESSION_VERSION to 0.16.0 (the first version exposing the tool-server event log flag) so the flag is guaranteed to exist, and enable it unconditionally like the artifacts list endpoint flag instead of best-effort. Co-Authored-By: Claude Opus 4.8 <[email protected]> * [build-tools] Address review: pin Argent event log path, tighten discovery, add orchestration test - Pin the event log path and pass it to both the tool-server (via ARGENT_EVENT_LOG) and the collector, so an ambient ARGENT_EVENT_LOG or a change to Argent's default can never make them disagree. - Only treat ENOENT as "no event file" in discovery; surface permission/I/O errors to Sentry via the collector's existing reporting. - Add an orchestration test covering the event-log flag enable, the shared path, and collector startup/cleanup ordering. Co-Authored-By: Claude Opus 4.8 <[email protected]> * [build-tools] Address review: drop naive capitalization and Argent summary fallback - Remove the capitalize() helper. Deriving prose from an identifier mangles casing that matters (iOS -> IOS), so the one message that started with the producer is now phrased to carry it mid-sentence and every diagnostic uses the producer id verbatim. - Argent's EventLogRecord requires `msg` and every emit site sets it to the human-readable description, so use it verbatim as the summary and drop the synthesized fallback. `msg` is now required in the schema, making a record without one a reported contract break rather than invented text. Co-Authored-By: Claude Opus 4.8 <[email protected]> --------- Co-authored-by: Claude Opus 4.8 <[email protected]>	2026-07-27 16:24:00 +02:00
Szymon DziedzicandClaude Opus 5	730c142c46	[eas-cli] Fix EAS logo not rendering in the root README (#4093 ) README.md at the repository root is a symlink to packages/eas-cli/README.md, so the same file is rendered by GitHub at two different depths. The relative `../../.github/resources/eas.svg` src resolves to /expo/eas-cli/raw/main/.github/resources/eas.svg on the package page, but walks above the repository root at the root page, where GitHub clamps it to /expo/eas-cli/.github/resources/eas.svg and the image 404s. Point the logo at an absolute raw URL so it resolves from both depths, and on npm. Co-authored-by: Claude Opus 5 <[email protected]>	2026-07-27 14:25:49 +02:00
Szymon DziedzicandClaude Opus 5	82de82bf7a	[eas-cli] Refresh README (#3844 ) * Refresh EAS CLI README Co-Authored-By: Claude Fable 5 <[email protected]> * Add changelog entry Co-Authored-By: Claude Fable 5 <[email protected]> * Link downloads badge to npm-stat instead of npmtrends npmtrends.com/eas-cli currently returns a 500 on direct load. Co-Authored-By: Claude Fable 5 <[email protected]> * Trim social badge row from README header Co-Authored-By: Claude Opus 4.8 <[email protected]> * [eas-cli] Address README review feedback Drop em dashes, link expo.dev/services instead of the redirecting expo.dev/eas, bump the eas.json version example to >=21.0.0, drop the retired Forums link, fix the 404ing dashboard link and the moved EAS Submit docs URL, and note that README.md's header is generated. Co-Authored-By: Claude Opus 5 <[email protected]> --------- Co-authored-by: Claude Fable 5 <[email protected]>	2026-07-27 14:08:59 +02:00
Szymon DziedzicandClaude Fable 5	d63d58203d	[eas-cli] Improve build request error details (#3982 ) * Improve build request error details * Add changelog entry * [eas-cli] Simplify build request error helpers, dedupe request ID by value - Dedupe the response request ID against GraphQL extension request IDs by comparing the IDs themselves instead of formatted-line substring matching - Always include the top-level error message in debug output instead of the conditional that tried to guess when it was redundant - Collapse formatResponseStatusLine/formatResponseRequestIdLine/ getResponseHeadersForDebug into their callers and rename the object-building helpers from format* to collect* - Pass graphQLErrors into formatBuildRequestErrorDetails instead of re-deriving it - Add tests for the x-request-id fallback, request ID dedupe, and the top-level error message fallback Co-Authored-By: Claude Fable 5 <[email protected]> --------- Co-authored-by: Claude Fable 5 <[email protected]>	2026-07-27 13:42:36 +02:00
Szymon Dziedzic	702d8808d3	[eas-cli] Use npx in agent-device simulator instructions (#4070 ) * [eas-cli] Use npx in agent-device simulator instructions * [eas-cli] Add changelog for simulator instructions	2026-07-27 13:00:49 +02:00
Brent Vatne	a98d929f14	[reviewer] Adopt ECR 0.6.0 trusted-base-commit trust model (#4092 )	2026-07-26 22:34:21 -07:00
Brent Vatne	8d005fe9c3	[reviewer] Switch the credential to the ChatGPT ACCESS token (#4090 )	2026-07-26 19:54:36 -07:00