From 106eebc56aabd3fc9072dcfbf437d1a6272953e2 Mon Sep 17 00:00:00 2001
From: Dario Kondratiuk <dariokondratiuk@gmail.com>
Date: Mon, 26 Oct 2026 16:17:44 -0300
Subject: [PATCH 1/5] Config: maxObservationBytes and maxInputTokens with
 observation cutting (closes #646)

Port upstream agent/observation-budget.ts: the agent keys, the byte budget
around what the request already costs, the cut of an over-budget screen in
acts and judgments, the judgment pre-flight, and the run limits.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DH1b4gwq2kmMK94pdZRQZm
---
 COMPATIBILITY.md                              |  12 +-
 README.md                                     |   2 +-
 .../api/E2E.Engine.BrowserDownload.html       |  13 ++
 docs-site/public/api/E2E.Engine.Dialog.html   |  13 ++
 .../public/api/E2E.Engine.DialogHandler.html  |  13 ++
 .../public/api/E2E.Engine.DialogType.html     |  13 ++
 .../api/E2E.Engine.EngineFixtureContext.html  |  13 ++
 .../api/E2E.Engine.IEngineFixtureHost.html    |  13 ++
 .../docs/api/E2E.Engine/DocumentElement.md    |  48 ++++----
 .../docs/api/E2E.Engine/DocumentPage.md       |  22 ++--
 .../docs/api/E2E.Engine/DocumentWorld.md      |   4 +-
 .../docs/api/E2E.Engine/EngineFinishInfo.md   |  12 +-
 .../docs/api/E2E.Engine/EngineInitInfo.md     |  12 +-
 .../docs/api/E2E.Engine/EnginePrepareInfo.md  |  14 +--
 .../api/E2E.Engine/EnginePrepareResult.md     |   6 +-
 .../docs/api/E2E.Engine/EngineScreenshot.md   |  10 +-
 .../docs/api/E2E.Engine/EngineStartOptions.md |  22 ++--
 .../content/docs/api/E2E.Engine/IEngine.md    |   2 +-
 .../docs/api/E2E.Engine/IEngineSession.md     |   2 +-
 .../content/docs/api/E2E.Engine/WebEngine.md  |   2 +-
 .../docs/api/E2E.OAuth/CopilotProvider.md     |   2 +-
 .../src/content/docs/api/E2E/ActOptions.md    |  14 +--
 .../src/content/docs/api/E2E/ActResult.md     |  10 +-
 .../src/content/docs/api/E2E/ActionEvent.md   |  12 +-
 .../src/content/docs/api/E2E/ActionHook.md    |   2 +-
 .../src/content/docs/api/E2E/ActionOptions.md |   4 +-
 .../src/content/docs/api/E2E/ActionSource.md  |   6 +-
 .../src/content/docs/api/E2E/AgentConfig.md   |  68 ++++++++---
 .../src/content/docs/api/E2E/AgentOptions.md  |  41 ++++++-
 .../src/content/docs/api/E2E/AppConfig.md     |  12 +-
 .../src/content/docs/api/E2E/AssertOptions.md |  10 +-
 .../src/content/docs/api/E2E/CacheConfig.md   |   8 +-
 .../src/content/docs/api/E2E/CacheInfo.md     |  18 +--
 .../src/content/docs/api/E2E/CacheMode.md     |   8 +-
 .../src/content/docs/api/E2E/E2EConfig.md     |  42 +++----
 .../src/content/docs/api/E2E/E2EDefaults.md   |  33 +++++
 .../src/content/docs/api/E2E/E2EFixture.md    |  84 +++++++++----
 .../src/content/docs/api/E2E/E2ESession.md    |   8 +-
 .../content/docs/api/E2E/E2ESessionOptions.md | 114 ++++++++++++------
 .../content/docs/api/E2E/ExtractOptions.md    |   8 +-
 docs-site/src/content/docs/api/E2E/Locator.md |   2 +-
 .../content/docs/api/E2E/LocatorExpression.md |  46 +++----
 .../docs/api/E2E/LocatorWaitForOptions.md     |   6 +-
 .../docs/api/E2E/PressSequentiallyOptions.md  |   4 +-
 .../docs/api/E2E/ScrollUntilVisibleOptions.md |   8 +-
 .../src/content/docs/api/E2E/TargetConfig.md  |  12 +-
 .../content/docs/api/E2E/WaitForOptions.md    |  12 +-
 .../src/content/docs/api/E2E/WaitForState.md  |  10 +-
 skills/e2e-dotnet/references/agent.md         |  20 ++-
 skills/e2e-dotnet/references/debugging.md     |   2 +-
 src/E2E/Agent/Act.cs                          |  16 ++-
 src/E2E/Agent/ActContext.cs                   |   5 +-
 src/E2E/Agent/ActTools.cs                     |   2 +-
 src/E2E/Agent/Agent.cs                        |  63 ++++++++--
 src/E2E/Agent/AgentObservation.cs             |   4 -
 src/E2E/Agent/AgentOptions.cs                 |  59 ++++++++-
 src/E2E/Agent/Model.cs                        |  21 ++++
 src/E2E/Agent/ObservationBudget.cs            |  53 ++++++++
 src/E2E/Agent/ObservationFeed.cs              |  74 +++++++++++-
 src/E2E/Agent/SnapshotText.cs                 |  71 ++++++++---
 src/E2E/Config/E2EConfig.cs                   |  47 +++++++-
 src/E2E/Config/E2EDefaults.cs                 |   9 ++
 src/E2E/Explore/Executor.cs                   |   4 +
 src/E2E/Explore/Explore.cs                    |   4 +
 src/E2E/Locator/Screen.cs                     |   2 +-
 src/E2E/Report/BuildReport.cs                 |   5 +-
 src/E2E/Report/ReportFile.cs                  |   6 +
 src/E2E/Report/ReportRecords.cs               |  16 ++-
 src/E2E/Run/AttemptReport.cs                  |   2 +-
 src/E2E/Run/E2EFixture.cs                     |   8 ++
 src/E2E/Run/E2ESession.cs                     |  14 ++-
 src/E2E/Run/FailureEvidence.cs                |   2 +-
 src/E2E/Run/StepScreens.cs                    |   3 -
 .../AgentConfig/ACustomExecutorTests.cs       |   2 +
 .../AgentConfig/AgentConfigDefaultsTests.cs   |  20 ++-
 tests/E2E.Tests/AgentConfig/RunLimitsTests.cs |  49 ++++++++
 .../AgentConfig/TheAgentsEntryShapeTests.cs   |   3 +-
 .../ObservationByteBudgetTests.cs             |  29 +++++
 .../PrepareObservationTests.cs                |  30 ++++-
 .../ObservationBudgetWiringTests.cs           |  87 +++++++++++++
 .../ObservationByteBudgetTests.cs             |  59 +++++++++
 tests/E2E.Tests/ConfigTests.cs                |   9 +-
 .../ReportStatus/ReportStatusBuilders.cs      |   4 +-
 .../E2E.Tests/ReportStatus/RunLimitsTests.cs  |  22 +++-
 84 files changed, 1295 insertions(+), 383 deletions(-)
 create mode 100644 docs-site/public/api/E2E.Engine.BrowserDownload.html
 create mode 100644 docs-site/public/api/E2E.Engine.Dialog.html
 create mode 100644 docs-site/public/api/E2E.Engine.DialogHandler.html
 create mode 100644 docs-site/public/api/E2E.Engine.DialogType.html
 create mode 100644 docs-site/public/api/E2E.Engine.EngineFixtureContext.html
 create mode 100644 docs-site/public/api/E2E.Engine.IEngineFixtureHost.html
 create mode 100644 src/E2E/Agent/ObservationBudget.cs
 create mode 100644 tests/E2E.Tests/AgentConfig/RunLimitsTests.cs
 create mode 100644 tests/E2E.Tests/AgentObservation/ObservationByteBudgetTests.cs
 create mode 100644 tests/E2E.Tests/AgentObservationBudget/ObservationBudgetWiringTests.cs
 create mode 100644 tests/E2E.Tests/AgentObservationBudget/ObservationByteBudgetTests.cs

diff --git a/COMPATIBILITY.md b/COMPATIBILITY.md
index 1c69ccf4..7daf83cd 100644
--- a/COMPATIBILITY.md
+++ b/COMPATIBILITY.md
@@ -128,7 +128,7 @@ Names are C# versions of the JavaScript API: `agent.act` is `ActAsync`, `screen.
 - The full locator action set (`dragTo`, `swipe`, `hover`, `setInputFiles`, `secondaryTap`, `longPress`, pointer points). `secondaryTap` and `longPress` have no counterpart in the document engine
 - The screen-level `screen.tapAt` and `screen.swipe`
 - Per-action options other than `timeout` (and `delay` for `pressSequentially`): click `modifiers` on a locator (the agent's `tap` and `double_tap` hold them, above), tap `position`, and the `{ label, value, index }` form of `selectOption`
-- Diff-only observations. Each model turn receives a full text snapshot
+- Diff-only observations. Each model turn receives a full text snapshot, cut at the observation byte budget (see [Agents](#agents))
 - Telemetry
 - `STEP_NOT_AWAITED`, the error that fails a test body, hook, or fixture teardown that returns before its `expect.poll` finished, and cancels that poll. The step recorder has `AbandonRunning` and records a step the test did not await as `STEP_NOT_AWAITED`, but no fixture calls it yet, and `expect.poll` is not a step. Nothing cancels a poll the test does not await, so it keeps reading until its timeout or the `CancellationToken` passed to it. The compiler warns (CS4014) only for a bare, un-awaited `Task` call in an `async` method
 - Browser fixture members `locator` and `frameLocator`, and the `expect(browser)` matcher `toHaveClass` (it needs `browser.locator`). They wait for the engine's `locate` to take a `frame` and a `selector` expression kind (#680); the web engine locates in the engine now (`LocateAsync`), over its tree
@@ -494,9 +494,7 @@ Not ported:
 - `AssertAsync` on an agent with an executor goes to it as a step of kind `Assert`, with the agent's budgets and `JudgmentTimeout`. An assert is never cached, and a passing one verifies the acts before it. `Vision` is refused with `UNSUPPORTED_CAPABILITY`, since the executor decides what its model sees, and `Screenshot` keeps its evidence after the verdict, bounded by the action timeout: a capture that outlives it is dropped and the verdict stands. `WaitForAsync` and `ExtractAsync` keep the judge, which is the executor's `Judge` or `Model`. `ExecutorCache.Off` never replays or records, and takes no look before the step. A step with the cache on that cannot read its first screen (no app opened) still runs, and records nothing
 - `TypeSecretAsync` fills a secret the step's params declared, and refuses with `POLICY_DENIED` any other name, a disabled or non-editable field, and a field whose purpose does not fit a password secret. A secret the attempt does not know is `AUTH_CREDENTIAL_UNAVAILABLE`. The built-in agent's `fill_secret` goes through the same check, so its refusals read as the dispatcher's messages and not as `Secret fill refused: ...`. `ExecutorStep.Params` is JSON: a `Secret` is its name and, when set, its purpose, and every string and key that holds a secret value the attempt knows is redacted. `ExecutorAttempt` has the session's `TestTitle` as `TestId`, a fresh id per session, and `Index` as the attempt number minus one; `ExecutorStep.Index` counts the agent steps of the attempt, where upstream's counts every step. `AttachTranscript` and `AttachScreenshotAsync` write under the attempt's results directory (`transcript-<n>.txt`, `screenshots/<n>-<label>.png`), and, as upstream, only under `E2E_DEBUG=1`. `AttachTurns` keeps the step's last 12 turns on the step record, redacted, as upstream's `attachTurns` does, and the tool loop reports every turn it takes with the same clips. Its loop notes cover the events the port's loop has (a reply without a tool call, a shrunk history); upstream's others (a forced tool choice, the wind-down notice, a resent stalled request) have no counterpart. Deliberate difference: upstream clips a turn's text and then redacts it, so a cut can split a secret and leave a part the redactor no longer matches. The port redacts first and clips after, both in the loop and again in `AttachTurns`, which also enforces the bounds itself (the last 12 turns, 8 calls of 200 characters, an outcome of 2048) for any executor. A clip never splits a surrogate pair. The loop does not yet attach its debug transcript. The port has no step events
 
-Not ported:
-
-- `maxObservationBytes` and `maxInputTokens`. The port sends each observation whole, so it has nothing to cut; the keys are rejected in `e2e.config.json`
+- `maxObservationBytes` and `maxInputTokens` are upstream's agent keys (`config/agent.ts`), in `e2e.config.json`, on `AgentOptions`, `E2ESessionOptions`, and the fixture. `ResolvedAgent.From` and the config check them as upstream's `boundedInt` does (`agents.default.maxInputTokens must be an integer from 1 through 1000000`; `maxObservationBytes` takes 1024 through 16777216), and the defaults are upstream's 262144 and 64000 (`E2EDefaults`). `ObservationBudget.ObservationByteBudget` is upstream's `observationByteBudget` (`agent/observation-budget.ts`), over `ModelAdapter.TokenUpperBound` and `ImageTokenUpperBound` (upstream's `adapter.ts`), both in UTF-8 bytes. `SnapshotText.Render` cuts the screen at that budget as `prepareObservation` does: the marker is reserved up front, the first node is always listed, and the first line that would pass the budget ends the screen with `[observation truncated at the resolved observation byte limit]`. A step that cut a screen reports `observationTruncated`. An act cuts each look at `ObservationFeed.Text` (upstream's `byteBudget` in `observation-feed.ts`) around what every turn resends: the context, the prior-step ledger, and the instruction. A judgment cuts at `Agent.ObservationByteBudget` (upstream's `invocation.ts`), around the system text, the instruction, and a screenshot when `Vision` is on; under `VisionMode.Only` the tree does not reach the request, so only `maxObservationBytes` bounds it. A judgment whose request is still over `maxInputTokens` fails with `STEP_BUDGET_EXHAUSTED` before it is sent (upstream's pre-flight in `sdk.ts`). Differences: the port's tree text is its own format (`Screen (/):` and `- role "name" [ref=e1]` lines), so the header counts against the budget, and upstream's second marker for an engine-cut tree is the port's `(More of the page is off screen. Scroll to reach it.)`, which a byte cut replaces. The act loop is not pre-flighted, as upstream's is not, and the port's tool loop resends its whole history, so a long act can still end in `CONTEXT_OVERFLOW`, which shrinks it. The run's limits (`ResolvedAgent.RunLimits`, upstream's `runLimits`) are the largest any agent allows, and the trace's screens, `screen.tree()`, the failure evidence, and the report's `limits` read them. Upstream's removed-key hints for the agent keys (`timeout`, `maxTurns`, `maxModelTokensPerCall`, `limits`) and the top-level `specVersion` and `limits` are ported. Tests: `AgentObservationBudget/ObservationByteBudgetTests` and `ObservationBudgetWiringTests` (.NET-only), `AgentObservation/ObservationByteBudgetTests`, and `AgentConfig/AgentConfigDefaultsTests` and `RunLimitsTests`.
 
 ## Explore
 
@@ -539,7 +537,7 @@ Differences:
 - `cache.strict` treats any replay that finds a recording but does not finish it as stale. Retries replay too, and a strict run never writes or deletes a recording, whatever `cache.mode` says
 - A launch or cleanup timeout fails with `ENVIRONMENT_UNAVAILABLE`
 - `trace` and `video` are accepted at the config root and on the target, as upstream. The modes are `off`, `on`, `retain-on-failure`, `on-first-retry`, and `on-all-retries` (`RecordingMode`, `RecordingSource`, `ResolvedRecording`). The mode is resolved as upstream's `resolveConfig` does it: the flag, else the target's key, else the config root's, else the default (`retain-on-failure` for `trace`, `off` for `video`), and a mistake in a target's key is reported even when the flag wins. The old `trace: 'all'` and `trace: 'retries'` spellings, bare or as `{ record }`, are refused with the mode they meant. The port records `video` on the web engine (see [Video](#video)) and writes the trace page (see [Trace page](#trace-page)): the settings are read and carried on `TargetConfig.Trace` and `Video`, the fixture's `Trace` and `Video` properties, and `E2ESessionOptions`. The port has no `--trace` and `--video` flags, so the .NET-only variables `E2E_TRACE` and `E2E_VIDEO` stand in for them, with source `Run`. `RecordingSource.Test` is the source of a setting made for one test; the port has no per-test option yet. The per-attempt rules (`attemptKeep`, `attemptVideo`, `keeps`, `recordsOnSomeAttempt`) are in `RecordingModes`, internal. The port has no config digest, so upstream's "keeps the mode, at the top and on a target, out of the digest" has no port; the replay cache key does not read these settings. `config.test.ts` tests are in `Config/`: `TraceTests` and `VideoTests` (the three of the four `it` that do not need a digest; the flag is the variable, so "lets a target override the config, and the flag override both" and "refuses a mode it does not know" are partial), `ArtifactsConfigTests` (only the old trace spellings; the port has no `artifacts` key), and "uses CI defaults for retries and workers..." in `ResolveConfigTests` (partial, no workers). `recording-modes.test.ts` is `RecordingModes/`
-- Not supported, and rejected with `INVALID_CONFIG`: `projectId`, `tests`, `failOnSkippedFailure`, `workers`, `artifacts`, `output`, `reporters`, `credentials`, `cache.store`, the non-URL `app` keys, and the agent keys `tools` (set `AgentOptions.Tools` in code), `executor` (set `AgentOptions.Executor` in code), `maxObservationBytes`, and `maxInputTokens`. Credentials still come from `E2E_USER_<NAME>_USERNAME` and `_PASSWORD`
+- Not supported, and rejected with `INVALID_CONFIG`: `projectId`, `tests`, `failOnSkippedFailure`, `workers`, `artifacts`, `output`, `reporters`, `credentials`, `cache.store`, the non-URL `app` keys, and the agent keys `tools` (set `AgentOptions.Tools` in code), and `executor` (set `AgentOptions.Executor` in code). Credentials still come from `E2E_USER_<NAME>_USERNAME` and `_PASSWORD`
 
 ## Web engine
 
@@ -599,7 +597,7 @@ What the trace page shows about the app is collected as upstream's `trace-feed.t
 - `EngineStartOptions.Screen` and `EngineStartOptions.Environment` are upstream's `EngineAttemptContext.screen` and `environment`. `TraceFeed` (`Engine/TraceFeed.cs`, internal) is upstream's class: after an action, `ScreenAfterActionAsync` captures the screen like an observation without publishing it, so the refs a test or the model holds stay valid, within one second; `TellEnvironment` tells the browser (`chromium 141.0`) and the page's user agent once an attempt, without anyone waiting for it. The web engine builds the feed when the attempt starts. It hands the screen after `OpenAsync`, `BackAsync`, `PerformAsync`, `PressAsync`, and `SwipeAsync` (upstream's `open`, `back`, `perform`, `pressKey`, and the viewport swipe), and tells the environment after `OpenAsync` and `BackAsync` (upstream's `navigating`). Upstream's `typeText` and the point actions have no engine member here.
 - An attempt that keeps a trace (the same keep rule as the video: `attemptKeep` of the resolved `trace` mode) hands the engine a `Screen` sink. An attempt that keeps none hands none, and takes no screen from what the test observes. The default mode, `retain-on-failure`, keeps one for every attempt, since the verdict is not known before the end.
 - `SessionScreens` (`Run/SessionScreens.cs`) is upstream's `screens` of `TargetSession` and `EnvironmentFacts` is its `createEnvironmentFacts`: a name told again overwrites, blank values are dropped, at most 8 facts, each redacted and then cut to 40 and 200 characters. The port has no `createEngineSession`, so they are classes of their own. `AttemptScope.ObserveAsync` shows each observation the test, the screen fixture, and the agent take to the same sink.
-- `StepRecorder.RecordScreen` and `StepScreens.CompareScreens` and `TraceScreen` (`Run/StepScreens.cs`) are upstream's `recordScreen` and `step-screens.ts`. A step keeps how the last screen it saw differs from the step before's (`StepRecord.Screen`): the node lines added, removed, or changed, without node ids, 12 at most. Differences: the engine hands the port a typed `Observation`, so `SessionScreens` has no check for a malformed snapshot or `treeUnavailable`, and no revision to mint. The screen's location is the route (`/todos`), not the whole URL, and a node that is hidden or `aria-hidden` is left out, as the lines the model reads leave it out. The byte budget is upstream's default of `agents.<name>.maxObservationBytes`, 262144, since the port has no such key.
+- `StepRecorder.RecordScreen` and `StepScreens.CompareScreens` and `TraceScreen` (`Run/StepScreens.cs`) are upstream's `recordScreen` and `step-screens.ts`. A step keeps how the last screen it saw differs from the step before's (`StepRecord.Screen`): the node lines added, removed, or changed, without node ids, 12 at most. Differences: the engine hands the port a typed `Observation`, so `SessionScreens` has no check for a malformed snapshot or `treeUnavailable`, and no revision to mint. The screen's location is the route (`/todos`), not the whole URL, and a node that is hidden or `aria-hidden` is left out, as the lines the model reads leave it out. The byte budget is the run's `maxObservationBytes`, the largest any agent allows (262144 by default), as upstream's `config.limits.maxObservationBytes`.
 - `E2ESession.Steps`, `E2ESession.Environment`, and `E2ESession.AppLog` (internal) hold what the page reads.
 - The app log is collected apart from the feed, as upstream does it. `EngineStartOptions.AppLog` and `EngineStartOptions.Navigation` are upstream's `EngineAttemptContext.appLog` and `navigation`, and `AppLogEntry` is its `AppLogEntry`; `AppLogSource` and `AppLogLevel`, the records' enums, are public for it. `AppLog.Install` and `NavigationLog` (`Engine/AppLog.cs`, internal) are `installAppLog` and `NavigationLog` of `web/src/app-log.ts`. On every context the web engine configures, a persistent one too, it reports console output (`error` and `assert` as errors, `warning`, `log` and `info` as info; `debug` and the rest are left out, and so is Chrome's `Failed to load resource:` echo, which the network lines tell), uncaught errors, failed requests (one the browser cancelled is left out), and responses with a status of 400 or more (5xx an error, 4xx a warning, a missing `/favicon.ico` left out). It tells where the page went: `navigated to /checkout`, `the new tab navigated to /help`, `frame "pay" loaded /embed`, and `the app opened a new tab at /help; the test stays on its page`. A navigation the engine makes itself is not told, since its step says it: `NavigatingAsync` (upstream's `navigating`) wraps `OpenAsync` and `BackAsync`, and also `ForwardAsync`, `ReloadAsync`, and `GotoAsync`, as upstream wraps `browser.goto`, `reload`, `back`, and `forward`. It also tells the environment, as upstream's `navigating` does. Differences: the console location is Playwright's `URL:line:column` string, read to `(at URL:line)`, and an uncaught error is the text Playwright gives (the message, then the first `at` frame), where upstream reads the error's name, message, and stack.
 - As upstream, a tab's first document is told by its opening, a page that is not the test's current page counts as a tab (so the test page's navigation while `RestartAsync` replaces it reads as a tab's), and a request a test aborts itself (`net::ERR_FAILED`, `ERR_BLOCKED_BY_CLIENT`) is logged: only the browser's own cancellations are left out.
@@ -658,7 +656,7 @@ Upstream writes `report.json`, a `report-1` document of the whole run (`report/b
 - `schema/report-v1.schema.json` is upstream's schema, unchanged. `schema/fixtures/report-v1.valid.json` and `report-v1.invalid.json` are upstream's fixtures. The E2E package packs `schema/*.schema.json` under `schema/` (not the fixtures), as upstream's `files` does. Upstream's other three schemas (`agent-judgment-v1`, `agent-judgment-v2`, `session-v1`) are not ported: their features are not.
 - `WriteReport` (`Report/WriteReport.cs`, internal) is upstream's `report/write.ts`: `WriteTextReportAsync`, `WriteJsonReportAsync` (two-space indent, a trailing newline), and `ToPosixPath`. `AtomicWrite.WriteFileAtomicAsync` is upstream's `writeFileAtomic` (`internal/atomic-write.ts`): a sibling temporary file with random bytes in its name, moved over the target; `AtomicWrite.WriteFileAtomic` is the synchronous twin (`writeFileAtomicSync`), which `FileStepCache.Write` uses because `IStepCache.Write` is synchronous. On Windows both retry a move the file system refused while another move was replacing the target or a reader held it open (see [Replay cache](#replay-cache)). The trace page and the failure screen file are written through `WriteTextReportAsync`, as upstream's `traces.ts` does (it replaces the port's own `TracePages.WriteTextAsync`). The writer serializes with the port's JSON defaults (camel case, null omitted), so a caller redacts the text and shapes the document. Difference: a string with a lone UTF-16 surrogate makes `WriteJsonReportAsync` throw, where `JSON.stringify` writes an escape; the builder that cuts text to the schema's limits must not split a surrogate pair. Not ported: the file `mode` option, and `fileReporter`, since the port has no reporters.
 - The schema is checked in tests only. The tests use JsonSchema.Net 8.0.5 (MIT; version 9 and later use another license), in the test helper project `tests/E2E.Tests.Schema`. The shipped package validates nothing and has no new dependency. `ReportSchema.AssertValidReport` is upstream's `assertValidReport`, with `format` asserted as Ajv does.
-- Run-level blocks (`Report/BuildReport.cs`, upstream's `report/build.ts`): `DescribeTarget`, `ProjectSource`, `ComputeSummary`, `DeriveRunStatus`, `ComputeUsage`, `SerializeTarget`, and `Build`, which assembles `Report1Document` with `ReportRun`'s new members (`Status`, `ExitCode`, `StartedAt`, `FinishedAt`, `Project`, `Environment`, `Vcs`, `Errors`, `Summary`, `Limits`, `Usage`). `ReportRun.Targets` are `ReportTarget`s now, not names. `ReportResult` gained `DeclarationIndex`, `Tags`, and `Selected`; `ReportArtifact` gained `Size`; `StepMetrics` gained `ObservationBytes` (the largest observation the step read, in bytes of the text a model reads; a judgment that sends pixels alone counts none, as upstream's does not; so `usage.maxObservationBytes` is the largest of them). `AttemptReport.Build` fills each kept file's `Size`, so `usage.artifactBytes` adds them up. The engine version of a per-attempt target is `IEngine.Version`, which the session carries in `AttemptScope.EngineVersion`; a blank version reads `unversioned`. `Git.RunAsync` removes the variables that point git at a repository (`GIT_DIR`, `GIT_WORK_TREE`, and the like) before it starts git, so a hook or wrapper cannot move the repository it reads; upstream passes the parent's environment through. A target's `baseOrigin` is the scheme, host, and non-default port of the app URL, without credentials, and only for http and https, as `new URL(...).origin` is for a web URL. Differences: the port has no serial groups, no `--last-failed` rerun (`carried`), and no `failOnSkippedFailure`, so `DeriveRunStatus` reads results only. `DescribeTarget` takes an `IEngine`, which has no name, so the engine name is its platform; its flag capabilities are spelled in camel case (`tapModifiers`); `stateCapability` is false, since the port has no state hooks. A target's environment is always `test` (no `app.environment` key), the project is `unknown` with a zero digest (no project id or config digest, as upstream reports without a config), `limits` are the defaults (the config rejects `maxObservationBytes` and `maxInputTokens`), and `environment.runtime` reads `.NET <version>` where upstream's reads `node <version>`.
+- Run-level blocks (`Report/BuildReport.cs`, upstream's `report/build.ts`): `DescribeTarget`, `ProjectSource`, `ComputeSummary`, `DeriveRunStatus`, `ComputeUsage`, `SerializeTarget`, and `Build`, which assembles `Report1Document` with `ReportRun`'s new members (`Status`, `ExitCode`, `StartedAt`, `FinishedAt`, `Project`, `Environment`, `Vcs`, `Errors`, `Summary`, `Limits`, `Usage`). `ReportRun.Targets` are `ReportTarget`s now, not names. `ReportResult` gained `DeclarationIndex`, `Tags`, and `Selected`; `ReportArtifact` gained `Size`; `StepMetrics` gained `ObservationBytes` (the largest observation the step read, in bytes of the text a model reads; a judgment that sends pixels alone counts none, as upstream's does not; so `usage.maxObservationBytes` is the largest of them). `AttemptReport.Build` fills each kept file's `Size`, so `usage.artifactBytes` adds them up. The engine version of a per-attempt target is `IEngine.Version`, which the session carries in `AttemptScope.EngineVersion`; a blank version reads `unversioned`. `Git.RunAsync` removes the variables that point git at a repository (`GIT_DIR`, `GIT_WORK_TREE`, and the like) before it starts git, so a hook or wrapper cannot move the repository it reads; upstream passes the parent's environment through. A target's `baseOrigin` is the scheme, host, and non-default port of the app URL, without credentials, and only for http and https, as `new URL(...).origin` is for a web URL. Differences: the port has no serial groups, no `--last-failed` rerun (`carried`), and no `failOnSkippedFailure`, so `DeriveRunStatus` reads results only. `DescribeTarget` takes an `IEngine`, which has no name, so the engine name is its platform; its flag capabilities are spelled in camel case (`tapModifiers`); `stateCapability` is false, since the port has no state hooks. A target's environment is always `test` (no `app.environment` key), the project is `unknown` with a zero digest (no project id or config digest, as upstream reports without a config), `limits` are the largest `maxObservationBytes` and `maxInputTokens` of the attempt's agents, merged across the tests of a run (the defaults without agents), and `environment.runtime` reads `.NET <version>` where upstream's reads `node <version>`.
 - .NET-only names in this part: `ReportEngine`, `ReportProject`, `ReportEnvironment` (upstream writes these as inline object shapes), `ReportRunStatus` (upstream's status string union), `BuildReportOptions.TargetProvenance` is upstream's own, `Git.RunAsync`'s `budget` parameter (for tests), and `DescribeTarget(platform, version, capabilities)` (the session knows its engine by those three, not as an `IEngine`).
 - `Vcs.DetectAsync` and `Git.RunAsync` (`Internal/Vcs.cs`, `Internal/Git.cs`) are upstream's `detectVcs` and `git` (`internal/vcs.ts`, `internal/git.ts`): git is asked with a one-second budget, and a checkout without git falls back to `GITHUB_SHA` and `GITHUB_HEAD_REF` or `GITHUB_REF_NAME`. Difference: a cancelled token surfaces as a cancellation, where upstream has no token.
 - Wire form (`Report/ReportWire.cs`, internal; upstream's `serialize*` functions and the report-1 shapes of `report/build.ts`). Upstream types the shapes and lets `JSON.stringify` drop what is absent; the port builds `JsonObject`s, which omit what is absent the same way. Text is cut to the schema's bounds without splitting a UTF-16 surrogate pair, and a lone surrogate reads as U+FFFD (`JSON.stringify` escapes it; the port's writer refuses it). A result's text goes through the redactors of that test's attempts, as its trace page does. `ReportError` gained `Category` and `Retryable`; the stack never enters (`SerializedError` has none). `ReportAttempt` gained `Id` (a UUID version 7, `AttemptScope.AttemptId`, now minted with the dashes), `StartedAt`, `Cleanup` (always `complete`: the port does not tell a failed or forced cleanup from the attempt), and `Skip`; `ReportResult` gained `Platform`; `ReportSkip` and `AttemptCleanup` are .NET-only. The run id is a UUID version 7, one per process. A result id is the full 64-hex SHA-256 that its directory name is the head of (the port's digest, not upstream's). `testId` is `file::title` as `AttemptReport.TestId` spells it.
diff --git a/README.md b/README.md
index e785e509..53f08959 100644
--- a/README.md
+++ b/README.md
@@ -280,7 +280,7 @@ A Claude Pro or Max plan cannot serve the agent. Anthropic allows that login onl
 
 From a clone of this repo, run the tool with `dotnet run --project src/E2E.Cli -- login github-copilot`.
 
-An agent entry also takes `judge` (the model id for `assert`, `waitFor`, and `extract`), `system`, `context`, `maxSteps`, `maxModelCalls`, `judgmentTimeout`, and `providerOptions`. `agents` can name more agents than `default`; a call picks one with its `Agent` option, such as `new ActOptions { Agent = "careful" }`. Project tools (`AgentTools` on the fixture) are code, so they are not config keys; see topic `agent`. So is a custom executor (`AgentExecutor` on the fixture, `AgentOptions.Executor`), which replaces the built-in agent for `act` and `assert` with a `ToolLoop` of your own tools or your own `IStepExecutor`; see topic `agent`.
+An agent entry also takes `judge` (the model id for `assert`, `waitFor`, and `extract`), `system`, `context`, `maxSteps`, `maxModelCalls`, `judgmentTimeout`, `maxObservationBytes` (the most bytes of the screen one model request carries, 1024 through 16777216, 262144 by default), `maxInputTokens` (the input one model request may carry, 1 through 1000000, 64000 by default; a dense screen is cut to fit under it), and `providerOptions`. `agents` can name more agents than `default`; a call picks one with its `Agent` option, such as `new ActOptions { Agent = "careful" }`. Project tools (`AgentTools` on the fixture) are code, so they are not config keys; see topic `agent`. So is a custom executor (`AgentExecutor` on the fixture, `AgentOptions.Executor`), which replaces the built-in agent for `act` and `assert` with a `ToolLoop` of your own tools or your own `IStepExecutor`; see topic `agent`.
 
 `cache.mode` is `off`, `read-only`, or `read-write`. Unset, it is `read-write` locally and `read-only` when `CI` is set. `cache.strict` fails a recording that no longer matches with `REPLAY_STALE` instead of running the step live. Under `cache.strict`, retries replay too, and the run never writes the cache. `cache.dir` resolves against the config file's directory. `E2E_CACHE_DIR` replaces it, so checkouts and worktrees of one project can share a replay cache without editing the config; the mode stays as configured. Parallel runs can share the directory: each write replaces its entry file atomically, and two writers on one key leave the last write. On Windows, a write the file system refuses while another write replaces the same entry, or while a reader holds it open, is retried for a moment before the step reports it as not written.
 
diff --git a/docs-site/public/api/E2E.Engine.BrowserDownload.html b/docs-site/public/api/E2E.Engine.BrowserDownload.html
new file mode 100644
index 00000000..0ff4c11f
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.BrowserDownload.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/BrowserDownload/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/BrowserDownload/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/BrowserDownload/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/BrowserDownload/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/public/api/E2E.Engine.Dialog.html b/docs-site/public/api/E2E.Engine.Dialog.html
new file mode 100644
index 00000000..cf680e83
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.Dialog.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/Dialog/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/Dialog/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/Dialog/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/Dialog/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/public/api/E2E.Engine.DialogHandler.html b/docs-site/public/api/E2E.Engine.DialogHandler.html
new file mode 100644
index 00000000..3b71683c
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.DialogHandler.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/DialogHandler/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/DialogHandler/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/DialogHandler/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/DialogHandler/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/public/api/E2E.Engine.DialogType.html b/docs-site/public/api/E2E.Engine.DialogType.html
new file mode 100644
index 00000000..ea49a249
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.DialogType.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/DialogType/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/DialogType/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/DialogType/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/DialogType/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/public/api/E2E.Engine.EngineFixtureContext.html b/docs-site/public/api/E2E.Engine.EngineFixtureContext.html
new file mode 100644
index 00000000..6c890f7a
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.EngineFixtureContext.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/EngineFixtureContext/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/EngineFixtureContext/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/EngineFixtureContext/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/EngineFixtureContext/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/public/api/E2E.Engine.IEngineFixtureHost.html b/docs-site/public/api/E2E.Engine.IEngineFixtureHost.html
new file mode 100644
index 00000000..e5d8db61
--- /dev/null
+++ b/docs-site/public/api/E2E.Engine.IEngineFixtureHost.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<link rel="canonical" href="https://hardkoded.github.io/e2e-dotnet/api/E2E.Engine/IEngineFixtureHost/">
+<meta http-equiv="refresh" content="0; url=/e2e-dotnet/api/E2E.Engine/IEngineFixtureHost/">
+<title>Redirecting…</title>
+<script>location.replace("/e2e-dotnet/api/E2E.Engine/IEngineFixtureHost/" + (location.hash || ""));</script>
+</head>
+<body>
+<p><a href="/e2e-dotnet/api/E2E.Engine/IEngineFixtureHost/">Continue</a></p>
+</body>
+</html>
diff --git a/docs-site/src/content/docs/api/E2E.Engine/DocumentElement.md b/docs-site/src/content/docs/api/E2E.Engine/DocumentElement.md
index b270dd2a..81e862bc 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/DocumentElement.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/DocumentElement.md
@@ -23,7 +23,7 @@ A mutable control on a [DocumentPage](/api/E2E.Engine/DocumentPage/).
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L442)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L456)
 
 ## Properties
 
@@ -42,7 +42,7 @@ Attributes `getAttribute` and `toHaveAttribute` read, such as `href` or `aria-la
 
 **Value:** [Dictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.dictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L479)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L493)
 
 <a id="E2E_Engine_DocumentElement_Checked_"></a>
 <a id="E2E_Engine_DocumentElement_Checked"></a>
@@ -57,7 +57,7 @@ public bool Checked { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L462)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L476)
 
 <a id="E2E_Engine_DocumentElement_Children_"></a>
 <a id="E2E_Engine_DocumentElement_Children"></a>
@@ -72,7 +72,7 @@ public List<DocumentElement> Children { get; }
 
 **Value:** [List&lt;DocumentElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.list-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L491)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L505)
 
 <a id="E2E_Engine_DocumentElement_Disabled_"></a>
 <a id="E2E_Engine_DocumentElement_Disabled"></a>
@@ -87,7 +87,7 @@ public bool Disabled { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L460)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L474)
 
 <a id="E2E_Engine_DocumentElement_Expanded_"></a>
 <a id="E2E_Engine_DocumentElement_Expanded"></a>
@@ -102,7 +102,7 @@ public bool Expanded { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L468)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L482)
 
 <a id="E2E_Engine_DocumentElement_Focused_"></a>
 <a id="E2E_Engine_DocumentElement_Focused"></a>
@@ -117,7 +117,7 @@ public bool Focused { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L474)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L488)
 
 <a id="E2E_Engine_DocumentElement_Hidden_"></a>
 <a id="E2E_Engine_DocumentElement_Hidden"></a>
@@ -132,7 +132,7 @@ public bool Hidden { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L464)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L478)
 
 <a id="E2E_Engine_DocumentElement_InputPurpose_"></a>
 <a id="E2E_Engine_DocumentElement_InputPurpose"></a>
@@ -147,7 +147,7 @@ public string? InputPurpose { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L456)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L470)
 
 <a id="E2E_Engine_DocumentElement_Level_"></a>
 <a id="E2E_Engine_DocumentElement_Level"></a>
@@ -162,7 +162,7 @@ public int? Level { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L458)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L472)
 
 <a id="E2E_Engine_DocumentElement_Name_"></a>
 <a id="E2E_Engine_DocumentElement_Name"></a>
@@ -177,7 +177,7 @@ public string? Name { get; set; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L446)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L460)
 
 <a id="E2E_Engine_DocumentElement_NavigateTo_"></a>
 <a id="E2E_Engine_DocumentElement_NavigateTo"></a>
@@ -192,7 +192,7 @@ public string? NavigateTo { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L476)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L490)
 
 <a id="E2E_Engine_DocumentElement_OnFill_"></a>
 <a id="E2E_Engine_DocumentElement_OnFill"></a>
@@ -207,7 +207,7 @@ public Action<string>? OnFill { get; init; }
 
 **Value:** [Action&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L486)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L500)
 
 <a id="E2E_Engine_DocumentElement_OnScroll_"></a>
 <a id="E2E_Engine_DocumentElement_OnScroll"></a>
@@ -224,7 +224,7 @@ Runs when this element is scrolled with [LocatorAction.Swipe](/api/E2E.Engine/Lo
 
 **Value:** [Action&lt;ScrollDirection&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L489)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L503)
 
 <a id="E2E_Engine_DocumentElement_OnTap_"></a>
 <a id="E2E_Engine_DocumentElement_OnTap"></a>
@@ -239,7 +239,7 @@ public Action? OnTap { get; init; }
 
 **Value:** [Action](https://learn.microsoft.com/dotnet/api/system.action)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L484)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L498)
 
 <a id="E2E_Engine_DocumentElement_Placeholder_"></a>
 <a id="E2E_Engine_DocumentElement_Placeholder"></a>
@@ -254,7 +254,7 @@ public string? Placeholder { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L454)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L468)
 
 <a id="E2E_Engine_DocumentElement_Pressed_"></a>
 <a id="E2E_Engine_DocumentElement_Pressed"></a>
@@ -269,7 +269,7 @@ public bool Pressed { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L470)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L484)
 
 <a id="E2E_Engine_DocumentElement_Rect_"></a>
 <a id="E2E_Engine_DocumentElement_Rect"></a>
@@ -286,7 +286,7 @@ The box `boundingBox` reports. Null when the page does not lay it out.
 
 **Value:** [BoundingBox](/api/E2E.Engine/BoundingBox/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L482)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L496)
 
 <a id="E2E_Engine_DocumentElement_Role_"></a>
 <a id="E2E_Engine_DocumentElement_Role"></a>
@@ -301,7 +301,7 @@ public string? Role { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L444)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L458)
 
 <a id="E2E_Engine_DocumentElement_Secure_"></a>
 <a id="E2E_Engine_DocumentElement_Secure"></a>
@@ -316,7 +316,7 @@ public bool Secure { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L472)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L486)
 
 <a id="E2E_Engine_DocumentElement_Selected_"></a>
 <a id="E2E_Engine_DocumentElement_Selected"></a>
@@ -331,7 +331,7 @@ public bool Selected { get; set; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L466)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L480)
 
 <a id="E2E_Engine_DocumentElement_TestId_"></a>
 <a id="E2E_Engine_DocumentElement_TestId"></a>
@@ -346,7 +346,7 @@ public string? TestId { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L452)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L466)
 
 <a id="E2E_Engine_DocumentElement_Text_"></a>
 <a id="E2E_Engine_DocumentElement_Text"></a>
@@ -361,7 +361,7 @@ public string? Text { get; set; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L448)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L462)
 
 <a id="E2E_Engine_DocumentElement_Value_"></a>
 <a id="E2E_Engine_DocumentElement_Value"></a>
@@ -376,4 +376,4 @@ public string? Value { get; set; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L450)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L464)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/DocumentPage.md b/docs-site/src/content/docs/api/E2E.Engine/DocumentPage.md
index a72caa38..0da1884f 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/DocumentPage.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/DocumentPage.md
@@ -23,7 +23,7 @@ One in-memory screen. Builder methods append controls in reading order.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L373)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L387)
 
 ## Properties
 
@@ -42,7 +42,7 @@ Runs when the viewport scrolls, for a page that loads more as it is scrolled. Th
 
 **Value:** [Action&lt;ScrollDirection&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L383)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L397)
 
 <a id="E2E_Engine_DocumentPage_Path_"></a>
 <a id="E2E_Engine_DocumentPage_Path"></a>
@@ -57,7 +57,7 @@ public string Path { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L380)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L394)
 
 ## Methods
 
@@ -81,7 +81,7 @@ public DocumentElement Button(string name, Action? onTap = null)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L392)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L406)
 
 <a id="E2E_Engine_DocumentPage_Checkbox_"></a>
 <a id="E2E_Engine_DocumentPage_Checkbox_System_String_System_Boolean_"></a>
@@ -103,7 +103,7 @@ public DocumentElement Checkbox(string name, bool isChecked = false)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L424)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L438)
 
 <a id="E2E_Engine_DocumentPage_Heading_"></a>
 <a id="E2E_Engine_DocumentPage_Heading_System_String_System_Int32_"></a>
@@ -125,7 +125,7 @@ public DocumentElement Heading(string name, int level = 1)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L387)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L401)
 
 <a id="E2E_Engine_DocumentPage_Link_"></a>
 <a id="E2E_Engine_DocumentPage_Link_System_String_System_String_"></a>
@@ -147,7 +147,7 @@ public DocumentElement Link(string name, string route)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L419)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L433)
 
 <a id="E2E_Engine_DocumentPage_Paragraph_"></a>
 <a id="E2E_Engine_DocumentPage_Paragraph_System_String_"></a>
@@ -168,7 +168,7 @@ public DocumentElement Paragraph(string text)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L414)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L428)
 
 <a id="E2E_Engine_DocumentPage_Status_"></a>
 <a id="E2E_Engine_DocumentPage_Status_System_String_System_Boolean_"></a>
@@ -190,7 +190,7 @@ public DocumentElement Status(string name, bool hidden = false)
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L397)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L411)
 
 <a id="E2E_Engine_DocumentPage_TestId_"></a>
 <a id="E2E_Engine_DocumentPage_TestId_System_String_System_String_System_String_"></a>
@@ -213,7 +213,7 @@ public DocumentElement TestId(string testId, string? role = null, string? name =
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L429)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L443)
 
 <a id="E2E_Engine_DocumentPage_Textbox_"></a>
 <a id="E2E_Engine_DocumentPage_Textbox_System_String_System_String_System_Boolean_"></a>
@@ -236,4 +236,4 @@ public DocumentElement Textbox(string name, string? value = null, bool secure =
 
 **Returns:** [DocumentElement](/api/E2E.Engine/DocumentElement/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L402)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L416)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/DocumentWorld.md b/docs-site/src/content/docs/api/E2E.Engine/DocumentWorld.md
index 5beff923..44052228 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/DocumentWorld.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/DocumentWorld.md
@@ -23,7 +23,7 @@ Routes a [DocumentEngine](/api/E2E.Engine/DocumentEngine/) can open. Each open b
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L343)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L357)
 
 ## Methods
 
@@ -47,4 +47,4 @@ public DocumentWorld Map(string route, Action<DocumentPage> build)
 
 **Returns:** [DocumentWorld](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L347)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/DocumentEngine.cs#L361)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EngineFinishInfo.md b/docs-site/src/content/docs/api/E2E.Engine/EngineFinishInfo.md
index 30c8299e..6bd4e499 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EngineFinishInfo.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EngineFinishInfo.md
@@ -26,7 +26,7 @@ gone, with the cleanup budget of one hook. Upstream's `EngineFinishInfo`.
 
 **Implements:** [IEquatable&lt;EngineFinishInfo&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L274)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L302)
 
 ## Properties
 
@@ -48,7 +48,7 @@ Upstream's `timeoutMs`.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L294)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L322)
 
 <a id="E2E_Engine_EngineFinishInfo_Env_"></a>
 <a id="E2E_Engine_EngineFinishInfo_Env"></a>
@@ -65,7 +65,7 @@ The run's environment, the same prepare saw.
 
 **Value:** [IReadOnlyDictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L283)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L311)
 
 <a id="E2E_Engine_EngineFinishInfo_Log_"></a>
 <a id="E2E_Engine_EngineFinishInfo_Log"></a>
@@ -82,7 +82,7 @@ Reports one line of progress, as [Log](/api/E2E.Engine/EnginePrepareInfo/#E2E_En
 
 **Value:** [Action&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L286)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L314)
 
 <a id="E2E_Engine_EngineFinishInfo_RunId_"></a>
 <a id="E2E_Engine_EngineFinishInfo_RunId"></a>
@@ -99,7 +99,7 @@ The run id.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L277)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L305)
 
 <a id="E2E_Engine_EngineFinishInfo_TargetName_"></a>
 <a id="E2E_Engine_EngineFinishInfo_TargetName"></a>
@@ -116,4 +116,4 @@ The target being finished.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L280)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L308)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EngineInitInfo.md b/docs-site/src/content/docs/api/E2E.Engine/EngineInitInfo.md
index 91f290f7..a2161be7 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EngineInitInfo.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EngineInitInfo.md
@@ -25,7 +25,7 @@ What a worker's init is given, once per worker, before its first attempt. Upstre
 
 **Implements:** [IEquatable&lt;EngineInitInfo&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L298)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L326)
 
 ## Properties
 
@@ -44,7 +44,7 @@ The run's environment with what prepare left in it.
 
 **Value:** [IReadOnlyDictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L308)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L336)
 
 <a id="E2E_Engine_EngineInitInfo_Log_"></a>
 <a id="E2E_Engine_EngineInitInfo_Log"></a>
@@ -59,7 +59,7 @@ public required Action<string> Log { get; init; }
 
 **Value:** [Action&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L310)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L338)
 
 <a id="E2E_Engine_EngineInitInfo_RunId_"></a>
 <a id="E2E_Engine_EngineInitInfo_RunId"></a>
@@ -74,7 +74,7 @@ public required string RunId { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L300)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L328)
 
 <a id="E2E_Engine_EngineInitInfo_TargetName_"></a>
 <a id="E2E_Engine_EngineInitInfo_TargetName"></a>
@@ -89,7 +89,7 @@ public required string TargetName { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L302)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L330)
 
 <a id="E2E_Engine_EngineInitInfo_WorkerSlot_"></a>
 <a id="E2E_Engine_EngineInitInfo_WorkerSlot"></a>
@@ -106,4 +106,4 @@ The worker slot this worker serves, `0` to the target's workers minus one.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L333)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareInfo.md b/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareInfo.md
index 2f3d8f37..527da175 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareInfo.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareInfo.md
@@ -26,7 +26,7 @@ process, before any worker exists. Upstream's `EnginePrepareInfo`.
 
 **Implements:** [IEquatable&lt;EnginePrepareInfo&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L217)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L245)
 
 ## Properties
 
@@ -47,7 +47,7 @@ environment.
 
 **Value:** [IReadOnlyDictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L237)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L265)
 
 <a id="E2E_Engine_EnginePrepareInfo_Log_"></a>
 <a id="E2E_Engine_EnginePrepareInfo_Log"></a>
@@ -65,7 +65,7 @@ Reports one line of progress. A run streams it as a notice to the reporter; the
 
 **Value:** [Action&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L249)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L277)
 
 <a id="E2E_Engine_EnginePrepareInfo_ProjectRoot_"></a>
 <a id="E2E_Engine_EnginePrepareInfo_ProjectRoot"></a>
@@ -83,7 +83,7 @@ Null leaves it to the working directory. Upstream's `projectRoot`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L243)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L271)
 
 <a id="E2E_Engine_EnginePrepareInfo_RunId_"></a>
 <a id="E2E_Engine_EnginePrepareInfo_RunId"></a>
@@ -100,7 +100,7 @@ The run id.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L220)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L248)
 
 <a id="E2E_Engine_EnginePrepareInfo_Slots_"></a>
 <a id="E2E_Engine_EnginePrepareInfo_Slots"></a>
@@ -119,7 +119,7 @@ The worker slots the run will start for this target, `0` to [Slots](#E2E_Engine_
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L230)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L258)
 
 <a id="E2E_Engine_EnginePrepareInfo_TargetName_"></a>
 <a id="E2E_Engine_EnginePrepareInfo_TargetName"></a>
@@ -136,4 +136,4 @@ The target being prepared.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L223)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L251)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareResult.md b/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareResult.md
index 7ba8132d..7eac0b4c 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareResult.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EnginePrepareResult.md
@@ -25,7 +25,7 @@ What prepare learned that the run must honour. Upstream's `EnginePrepareResult`.
 
 **Implements:** [IEquatable&lt;EnginePrepareResult&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L253)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L281)
 
 ## Properties
 
@@ -45,7 +45,7 @@ Variables every worker of this target is started with, on top of the run's envir
 
 **Value:** [IReadOnlyDictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L267)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L295)
 
 <a id="E2E_Engine_EnginePrepareResult_Workers_"></a>
 <a id="E2E_Engine_EnginePrepareResult_Workers"></a>
@@ -65,4 +65,4 @@ this repository reads it.
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L261)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L289)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EngineScreenshot.md b/docs-site/src/content/docs/api/E2E.Engine/EngineScreenshot.md
index 8bb59199..83333e5b 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EngineScreenshot.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EngineScreenshot.md
@@ -25,7 +25,7 @@ A captured viewport: PNG bytes, and how many image pixels one viewport (CSS) pix
 
 **Implements:** [IEquatable&lt;EngineScreenshot&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L211)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L239)
 
 ## Constructors
 
@@ -50,7 +50,7 @@ A captured viewport: PNG bytes, and how many image pixels one viewport (CSS) pix
 | `Scale` | [double](https://learn.microsoft.com/dotnet/api/system.double) | Image pixels per viewport (CSS) pixel. |
 | `MaskedRegionCount` | [int?](https://learn.microsoft.com/dotnet/api/system.int32) | How many regions the engine covered, so a caller can prove the image is at least as redacted as the tree. Null when the engine cannot say. |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L211)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L239)
 
 ## Properties
 
@@ -69,7 +69,7 @@ How many regions the engine covered, so a caller can prove the image is at least
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L211)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L239)
 
 <a id="E2E_Engine_EngineScreenshot_Png_"></a>
 <a id="E2E_Engine_EngineScreenshot_Png"></a>
@@ -86,7 +86,7 @@ The image, with every secure field covered.
 
 **Value:** [byte\[\]](https://learn.microsoft.com/dotnet/api/system.byte)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L211)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L239)
 
 <a id="E2E_Engine_EngineScreenshot_Scale_"></a>
 <a id="E2E_Engine_EngineScreenshot_Scale"></a>
@@ -103,4 +103,4 @@ Image pixels per viewport (CSS) pixel.
 
 **Value:** [double](https://learn.microsoft.com/dotnet/api/system.double)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L211)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L239)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/EngineStartOptions.md b/docs-site/src/content/docs/api/E2E.Engine/EngineStartOptions.md
index 4be71dee..bb9e45ac 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/EngineStartOptions.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/EngineStartOptions.md
@@ -23,7 +23,7 @@ Passed to `CancellationToken)` once per test attempt.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L40)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L68)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public TimeSpan ActionTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L44)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L72)
 
 <a id="E2E_Engine_EngineStartOptions_AppLog_"></a>
 <a id="E2E_Engine_EngineStartOptions_AppLog"></a>
@@ -59,7 +59,7 @@ step records; the harness redacts and bounds each line, and a sink that throws n
 
 **Value:** [Action&lt;AppLogEntry&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L93)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L121)
 
 <a id="E2E_Engine_EngineStartOptions_ArtifactsDir_"></a>
 <a id="E2E_Engine_EngineStartOptions_ArtifactsDir"></a>
@@ -77,7 +77,7 @@ The attempt's artifact directory: where a recording of the attempt is written, u
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L72)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L100)
 
 <a id="E2E_Engine_EngineStartOptions_AttemptId_"></a>
 <a id="E2E_Engine_EngineStartOptions_AttemptId"></a>
@@ -95,7 +95,7 @@ Upstream's `EngineAttemptContext.attemptId`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L59)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L87)
 
 <a id="E2E_Engine_EngineStartOptions_BaseUrl_"></a>
 <a id="E2E_Engine_EngineStartOptions_BaseUrl"></a>
@@ -110,7 +110,7 @@ public string? BaseUrl { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L42)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L70)
 
 <a id="E2E_Engine_EngineStartOptions_Env_"></a>
 <a id="E2E_Engine_EngineStartOptions_Env"></a>
@@ -129,7 +129,7 @@ to the process environment.
 
 **Value:** [IReadOnlyDictionary&lt;string, string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L66)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L94)
 
 <a id="E2E_Engine_EngineStartOptions_Environment_"></a>
 <a id="E2E_Engine_EngineStartOptions_Environment"></a>
@@ -148,7 +148,7 @@ fails the attempt for it.
 
 **Value:** [Action&lt;IReadOnlyDictionary&lt;string, string&gt;&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L86)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L114)
 
 <a id="E2E_Engine_EngineStartOptions_Navigation_"></a>
 <a id="E2E_Engine_EngineStartOptions_Navigation"></a>
@@ -166,7 +166,7 @@ Upstream's `EngineAttemptContext.navigation`. A navigation the engine started it
 
 **Value:** [Action&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L99)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L127)
 
 <a id="E2E_Engine_EngineStartOptions_ProjectRoot_"></a>
 <a id="E2E_Engine_EngineStartOptions_ProjectRoot"></a>
@@ -183,7 +183,7 @@ Anchors the files the engine options name, such as an init script's `Path`. Defa
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L47)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L75)
 
 <a id="E2E_Engine_EngineStartOptions_Screen_"></a>
 <a id="E2E_Engine_EngineStartOptions_Screen"></a>
@@ -202,4 +202,4 @@ fails the action for it, and a sink that throws never fails the attempt.
 
 **Value:** [Action&lt;Observation&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L79)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L107)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/IEngine.md b/docs-site/src/content/docs/api/E2E.Engine/IEngine.md
index bb023b0c..eb629e2f 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/IEngine.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/IEngine.md
@@ -25,4 +25,4 @@ a recording re-finds its nodes at replay.
 
 **Derived:** [DocumentEngine](/api/E2E.Engine/DocumentEngine/), [WebEngine](/api/E2E.Engine/WebEngine/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L114)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L142)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/IEngineSession.md b/docs-site/src/content/docs/api/E2E.Engine/IEngineSession.md
index bca47a6e..7cf86dfb 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/IEngineSession.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/IEngineSession.md
@@ -21,4 +21,4 @@ public interface IEngineSession : IAsyncDisposable
 
 One attempt's session with the app. Disposed at the end of the attempt, after `afterEach`.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L126)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Engine/IEngine.cs#L154)
diff --git a/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md b/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
index 974b57b8..e496011a 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
@@ -28,7 +28,7 @@ same node actions the document engine does. Install browsers once with
 
 **Implements:** [IEngine](/api/E2E.Engine/IEngine/), [IAsyncDisposable](https://learn.microsoft.com/dotnet/api/system.iasyncdisposable)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L370)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L392)
 
 ## Constructors
 
diff --git a/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md b/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
index 90f647f2..69cc8dce 100644
--- a/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
+++ b/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
@@ -27,7 +27,7 @@ expire; a 401 means signing in again.
 
 **Implements:** [IOAuthProvider](/api/E2E.OAuth/IOAuthProvider/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L1478)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L1500)
 
 ## Constructors
 
diff --git a/docs-site/src/content/docs/api/E2E/ActOptions.md b/docs-site/src/content/docs/api/E2E/ActOptions.md
index 199beefb..0ca05d3a 100644
--- a/docs-site/src/content/docs/api/E2E/ActOptions.md
+++ b/docs-site/src/content/docs/api/E2E/ActOptions.md
@@ -23,7 +23,7 @@ Values passed into one `CancellationToken)` goal. Put fresh data in [Unique(stri
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L902)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L949)
 
 ## Properties
 
@@ -42,7 +42,7 @@ The named agent that runs the step. Defaults to `default`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L915)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L962)
 
 <a id="E2E_ActOptions_MaxModelCalls_"></a>
 <a id="E2E_ActOptions_MaxModelCalls"></a>
@@ -59,7 +59,7 @@ Model-call budget. Defaults to the configured `MaxModelCalls` and can only lower
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L912)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L959)
 
 <a id="E2E_ActOptions_MaxSteps_"></a>
 <a id="E2E_ActOptions_MaxSteps"></a>
@@ -76,7 +76,7 @@ Action budget. Defaults to the configured `MaxSteps` (25) and can only lower it.
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L909)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L956)
 
 <a id="E2E_ActOptions_OnAction_"></a>
 <a id="E2E_ActOptions_OnAction"></a>
@@ -95,7 +95,7 @@ nothing from it. A throw fails the step.
 
 **Value:** [ActionHook](/api/E2E/ActionHook/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L922)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L969)
 
 <a id="E2E_ActOptions_Params_"></a>
 <a id="E2E_ActOptions_Params"></a>
@@ -110,7 +110,7 @@ public IReadOnlyDictionary<string, object?>? Params { get; init; }
 
 **Value:** [IReadOnlyDictionary&lt;string, object&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L904)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L951)
 
 <a id="E2E_ActOptions_Timeout_"></a>
 <a id="E2E_ActOptions_Timeout"></a>
@@ -125,4 +125,4 @@ public TimeSpan? Timeout { get; init; }
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L906)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L953)
diff --git a/docs-site/src/content/docs/api/E2E/ActResult.md b/docs-site/src/content/docs/api/E2E/ActResult.md
index e37b60fd..632e2761 100644
--- a/docs-site/src/content/docs/api/E2E/ActResult.md
+++ b/docs-site/src/content/docs/api/E2E/ActResult.md
@@ -21,7 +21,7 @@ public sealed class ActResult
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L999)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1046)
 
 ## Properties
 
@@ -40,7 +40,7 @@ Actions the step performed, replayed or live, counting ones that failed.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1013)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1060)
 
 <a id="E2E_ActResult_Cache_"></a>
 <a id="E2E_ActResult_Cache"></a>
@@ -58,7 +58,7 @@ Null when caching is off. `self-finalized` finished with no model call,
 
 **Value:** [CacheInfo](/api/E2E/CacheInfo/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1007)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1054)
 
 <a id="E2E_ActResult_ModelCalls_"></a>
 <a id="E2E_ActResult_ModelCalls"></a>
@@ -75,7 +75,7 @@ Model calls the step spent. 0 when a replay finished it.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1010)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1057)
 
 <a id="E2E_ActResult_Summary_"></a>
 <a id="E2E_ActResult_Summary"></a>
@@ -90,4 +90,4 @@ public required string Summary { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1001)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1048)
diff --git a/docs-site/src/content/docs/api/E2E/ActionEvent.md b/docs-site/src/content/docs/api/E2E/ActionEvent.md
index 9dbf392c..7714bcfb 100644
--- a/docs-site/src/content/docs/api/E2E/ActionEvent.md
+++ b/docs-site/src/content/docs/api/E2E/ActionEvent.md
@@ -25,7 +25,7 @@ One completed action of an `agent.act` step, as [OnAction](/api/E2E/ActOptions/#
 
 **Implements:** [IEquatable&lt;ActionEvent&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
 
 ## Constructors
 
@@ -51,7 +51,7 @@ One completed action of an `agent.act` step, as [OnAction](/api/E2E/ActOptions/#
 | `Summary` | [string](https://learn.microsoft.com/dotnet/api/system.string) | What the action did, secrets redacted. |
 | `Source` | [ActionSource](/api/E2E/ActionSource/) | Who chose the action. |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
 
 ## Properties
 
@@ -70,7 +70,7 @@ The committed action, such as `tap` or `navigate`; a mutating project tool reads
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
 
 <a id="E2E_ActionEvent_Index_"></a>
 <a id="E2E_ActionEvent_Index"></a>
@@ -87,7 +87,7 @@ public int Index { get; init; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
 
 <a id="E2E_ActionEvent_Source_"></a>
 <a id="E2E_ActionEvent_Source"></a>
@@ -104,7 +104,7 @@ Who chose the action.
 
 **Value:** [ActionSource](/api/E2E/ActionSource/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
 
 <a id="E2E_ActionEvent_Summary_"></a>
 <a id="E2E_ActionEvent_Summary"></a>
@@ -121,4 +121,4 @@ What the action did, secrets redacted.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
diff --git a/docs-site/src/content/docs/api/E2E/ActionHook.md b/docs-site/src/content/docs/api/E2E/ActionHook.md
index b18da9e6..cb3db859 100644
--- a/docs-site/src/content/docs/api/E2E/ActionHook.md
+++ b/docs-site/src/content/docs/api/E2E/ActionHook.md
@@ -29,4 +29,4 @@ The `onAction` hook of an `agent.act` call.
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L926)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L973)
diff --git a/docs-site/src/content/docs/api/E2E/ActionOptions.md b/docs-site/src/content/docs/api/E2E/ActionOptions.md
index 83d63b9d..bcd5dd2e 100644
--- a/docs-site/src/content/docs/api/E2E/ActionOptions.md
+++ b/docs-site/src/content/docs/api/E2E/ActionOptions.md
@@ -25,7 +25,7 @@ Options for one locator action.
 
 **Derived:** [PressSequentiallyOptions](/api/E2E/PressSequentiallyOptions/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L938)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L939)
 
 ## Properties
 
@@ -44,4 +44,4 @@ How long to wait for exactly one enabled match. Defaults to the configured actio
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L941)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L942)
diff --git a/docs-site/src/content/docs/api/E2E/ActionSource.md b/docs-site/src/content/docs/api/E2E/ActionSource.md
index bc1fdd83..cd22568f 100644
--- a/docs-site/src/content/docs/api/E2E/ActionSource.md
+++ b/docs-site/src/content/docs/api/E2E/ActionSource.md
@@ -21,7 +21,7 @@ public enum ActionSource
 
 Who chose an action an [ActionEvent](/api/E2E/ActionEvent/) reports.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L936)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L983)
 
 ## Fields
 
@@ -39,7 +39,7 @@ The executor chose the action.
 
 **Value:** [ActionSource](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L939)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L986)
 
 <a id="E2E_ActionSource_Replay"></a>
 
@@ -55,4 +55,4 @@ The replay cache replayed the action.
 
 **Value:** [ActionSource](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L942)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L989)
diff --git a/docs-site/src/content/docs/api/E2E/AgentConfig.md b/docs-site/src/content/docs/api/E2E/AgentConfig.md
index 46416a4a..9f6f8d04 100644
--- a/docs-site/src/content/docs/api/E2E/AgentConfig.md
+++ b/docs-site/src/content/docs/api/E2E/AgentConfig.md
@@ -25,7 +25,7 @@ Each entry starts from the defaults; none inherits another's values.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L720)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L768)
 
 ## Fields
 
@@ -41,7 +41,7 @@ public const string DefaultProvider = "openai"
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L722)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L770)
 
 ## Properties
 
@@ -60,7 +60,7 @@ The environment variable holding the key. Unset, the one the provider reads, suc
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L753)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L801)
 
 <a id="E2E_AgentConfig_BaseUrl_"></a>
 <a id="E2E_AgentConfig_BaseUrl"></a>
@@ -77,7 +77,7 @@ The API root. Unset, the provider's own; for `azure` it is built from `AZURE_RES
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L750)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L798)
 
 <a id="E2E_AgentConfig_Context_"></a>
 <a id="E2E_AgentConfig_Context"></a>
@@ -94,7 +94,7 @@ Project context told to every model call, at most 16384 UTF-8 bytes.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L747)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L795)
 
 <a id="E2E_AgentConfig_Judge_"></a>
 <a id="E2E_AgentConfig_Judge"></a>
@@ -111,7 +111,7 @@ The model id that judges `assert`, `waitFor`, and `extract`. Unset, the judge is
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L738)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L786)
 
 <a id="E2E_AgentConfig_JudgmentTimeout_"></a>
 <a id="E2E_AgentConfig_JudgmentTimeout"></a>
@@ -126,7 +126,24 @@ public TimeSpan JudgmentTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L761)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L809)
+
+<a id="E2E_AgentConfig_MaxInputTokens_"></a>
+<a id="E2E_AgentConfig_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public int MaxInputTokens { get; init; }
+```
+
+
+1 through 1000000. See [MaxInputTokens](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxInputTokens).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L815)
 
 <a id="E2E_AgentConfig_MaxModelCalls_"></a>
 <a id="E2E_AgentConfig_MaxModelCalls"></a>
@@ -143,7 +160,24 @@ public int? MaxModelCalls { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L759)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L807)
+
+<a id="E2E_AgentConfig_MaxObservationBytes_"></a>
+<a id="E2E_AgentConfig_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public int MaxObservationBytes { get; init; }
+```
+
+
+1024 through 16777216. See [MaxObservationBytes](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxObservationBytes).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L812)
 
 <a id="E2E_AgentConfig_MaxSteps_"></a>
 <a id="E2E_AgentConfig_MaxSteps"></a>
@@ -160,7 +194,7 @@ public int? MaxSteps { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L756)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L804)
 
 <a id="E2E_AgentConfig_Model_"></a>
 <a id="E2E_AgentConfig_Model"></a>
@@ -175,7 +209,7 @@ public string? Model { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L735)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L783)
 
 <a id="E2E_AgentConfig_Provider_"></a>
 <a id="E2E_AgentConfig_Provider"></a>
@@ -192,7 +226,7 @@ Who serves [Model](#E2E_AgentConfig_Model) and [Judge](#E2E_AgentConfig_Judge).
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L741)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L789)
 
 <a id="E2E_AgentConfig_ProviderOptions_"></a>
 <a id="E2E_AgentConfig_ProviderOptions"></a>
@@ -209,7 +243,7 @@ Provider options by provider. Each client adds the entry under its own key to it
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L764)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L818)
 
 <a id="E2E_AgentConfig_Providers_"></a>
 <a id="E2E_AgentConfig_Providers"></a>
@@ -228,7 +262,7 @@ subscription logins (`chatgpt`, `copilot`, `grok`, `opencode-console`).
 
 **Value:** [IReadOnlyList&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L729)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L777)
 
 <a id="E2E_AgentConfig_System_"></a>
 <a id="E2E_AgentConfig_System"></a>
@@ -245,7 +279,7 @@ Text appended to the act rules. Judges never see it.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L744)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L792)
 
 ## Methods
 
@@ -264,7 +298,7 @@ The model for [Judge](#E2E_AgentConfig_Judge), or null when no judge is set.
 
 **Returns:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L770)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L824)
 
 <a id="E2E_AgentConfig_CreateModel_"></a>
 <a id="E2E_AgentConfig_CreateModel"></a>
@@ -281,7 +315,7 @@ The model for [Model](#E2E_AgentConfig_Model), or null when no model is set.
 
 **Returns:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L767)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L821)
 
 <a id="E2E_AgentConfig_CreateOptions_"></a>
 <a id="E2E_AgentConfig_CreateOptions"></a>
@@ -298,4 +332,4 @@ The [AgentOptions](/api/E2E/AgentOptions/) this entry describes, with its models
 
 **Returns:** [AgentOptions](/api/E2E/AgentOptions/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L773)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L827)
diff --git a/docs-site/src/content/docs/api/E2E/AgentOptions.md b/docs-site/src/content/docs/api/E2E/AgentOptions.md
index ade1e3cb..d676be1b 100644
--- a/docs-site/src/content/docs/api/E2E/AgentOptions.md
+++ b/docs-site/src/content/docs/api/E2E/AgentOptions.md
@@ -100,6 +100,25 @@ Deadline of one `assert`, `waitFor`, or `extract`.
 
 [View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L55)
 
+<a id="E2E_AgentOptions_MaxInputTokens_"></a>
+<a id="E2E_AgentOptions_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public int MaxInputTokens { get; init; }
+```
+
+
+The input one model request of this agent may carry, upstream's `maxInputTokens`, 1 through 1000000, counted as upstream's
+`tokenUpperBound` does: in UTF-8 bytes. The screen is cut to fit under it, and a judgment whose request is over it fails
+with `STEP_BUDGET_EXHAUSTED` before it is sent.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L68)
+
 <a id="E2E_AgentOptions_MaxModelCalls_"></a>
 <a id="E2E_AgentOptions_MaxModelCalls"></a>
 
@@ -117,6 +136,24 @@ Model requests per agent call, 1 through 100. Null leaves it unset: [MaxModelCal
 
 [View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L52)
 
+<a id="E2E_AgentOptions_MaxObservationBytes_"></a>
+<a id="E2E_AgentOptions_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public int MaxObservationBytes { get; init; }
+```
+
+
+The most bytes of the screen one model request carries, upstream's `maxObservationBytes`, 1024 through 16777216. A
+screen over it is cut and ends with a marker. The per-call [MaxInputTokens](#E2E_AgentOptions_MaxInputTokens) ceiling binds first on a large screen.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L61)
+
 <a id="E2E_AgentOptions_MaxSteps_"></a>
 <a id="E2E_AgentOptions_MaxSteps"></a>
 
@@ -168,7 +205,7 @@ adds the fields under its [Provider](/api/E2E/OpenAiCompatibleModelOptions/#E2E_
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L61)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L74)
 
 <a id="E2E_AgentOptions_System_"></a>
 <a id="E2E_AgentOptions_System"></a>
@@ -204,4 +241,4 @@ declares, and a name the agent already uses is refused.
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentTool&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L67)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/AgentOptions.cs#L80)
diff --git a/docs-site/src/content/docs/api/E2E/AppConfig.md b/docs-site/src/content/docs/api/E2E/AppConfig.md
index 69dd5057..47d37bb5 100644
--- a/docs-site/src/content/docs/api/E2E/AppConfig.md
+++ b/docs-site/src/content/docs/api/E2E/AppConfig.md
@@ -21,7 +21,7 @@ public sealed class AppConfig
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L708)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L735)
 
 ## Properties
 
@@ -40,7 +40,7 @@ The build a device target installs, relative to the folder of `e2e.config.json`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L720)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L747)
 
 <a id="E2E_AppConfig_BundleId_"></a>
 <a id="E2E_AppConfig_BundleId"></a>
@@ -57,7 +57,7 @@ The bundle id (iOS) or package (Android) of an installed app a device target lau
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L717)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L744)
 
 <a id="E2E_AppConfig_Command_"></a>
 <a id="E2E_AppConfig_Command"></a>
@@ -76,7 +76,7 @@ The command that starts the app (upstream's `app.command`), started before the f
 
 **Value:** [CommandConfig](/api/E2E/CommandConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L727)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L754)
 
 <a id="E2E_AppConfig_ReadyUrl_"></a>
 <a id="E2E_AppConfig_ReadyUrl"></a>
@@ -93,7 +93,7 @@ The URL that answers once [Command](#E2E_AppConfig_Command) has started the app
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L730)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L757)
 
 <a id="E2E_AppConfig_Url_"></a>
 <a id="E2E_AppConfig_Url"></a>
@@ -111,4 +111,4 @@ Relative URLs resolve against it.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L714)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L741)
diff --git a/docs-site/src/content/docs/api/E2E/AssertOptions.md b/docs-site/src/content/docs/api/E2E/AssertOptions.md
index bf7a0296..7135f475 100644
--- a/docs-site/src/content/docs/api/E2E/AssertOptions.md
+++ b/docs-site/src/content/docs/api/E2E/AssertOptions.md
@@ -23,7 +23,7 @@ public sealed class AssertOptions
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L946)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L993)
 
 ## Properties
 
@@ -42,7 +42,7 @@ The named agent whose judge decides. Defaults to `default`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L961)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1008)
 
 <a id="E2E_AssertOptions_Screenshot_"></a>
 <a id="E2E_AssertOptions_Screenshot"></a>
@@ -60,7 +60,7 @@ Keep a redacted screenshot of the judged screen under the attempt's results, and
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L958)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1005)
 
 <a id="E2E_AssertOptions_Timeout_"></a>
 <a id="E2E_AssertOptions_Timeout"></a>
@@ -77,7 +77,7 @@ Defaults to the agent's `JudgmentTimeout` (30 s).
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L949)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L996)
 
 <a id="E2E_AssertOptions_Vision_"></a>
 <a id="E2E_AssertOptions_Vision"></a>
@@ -94,4 +94,4 @@ What the judge is shown. [Off](/api/E2E/VisionMode/#E2E_VisionMode_Off) by defau
 
 **Value:** [VisionMode](/api/E2E/VisionMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L952)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L999)
diff --git a/docs-site/src/content/docs/api/E2E/CacheConfig.md b/docs-site/src/content/docs/api/E2E/CacheConfig.md
index 7bfd8c1e..2f4e082b 100644
--- a/docs-site/src/content/docs/api/E2E/CacheConfig.md
+++ b/docs-site/src/content/docs/api/E2E/CacheConfig.md
@@ -21,7 +21,7 @@ public sealed class CacheConfig
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L865)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L921)
 
 ## Properties
 
@@ -40,7 +40,7 @@ Absolute cache directory. `cache.dir` resolves against the config directory; the
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L871)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L927)
 
 <a id="E2E_CacheConfig_Mode_"></a>
 <a id="E2E_CacheConfig_Mode"></a>
@@ -57,7 +57,7 @@ Unset, it is [ReadWrite](/api/E2E/CacheMode/#E2E_CacheMode_ReadWrite), or [ReadO
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L868)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L924)
 
 <a id="E2E_CacheConfig_Strict_"></a>
 <a id="E2E_CacheConfig_Strict"></a>
@@ -74,4 +74,4 @@ When true, a recording that no longer matches fails with `REPLAY_STALE` instead
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L874)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L930)
diff --git a/docs-site/src/content/docs/api/E2E/CacheInfo.md b/docs-site/src/content/docs/api/E2E/CacheInfo.md
index 91083e0f..1fe20717 100644
--- a/docs-site/src/content/docs/api/E2E/CacheInfo.md
+++ b/docs-site/src/content/docs/api/E2E/CacheInfo.md
@@ -21,7 +21,7 @@ public sealed class CacheInfo
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1016)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1063)
 
 ## Properties
 
@@ -40,7 +40,7 @@ Where the replay stopped and why, after a hand-off. After an `end-mismatch` it n
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1029)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1076)
 
 <a id="E2E_CacheInfo_Entry_"></a>
 <a id="E2E_CacheInfo_Entry"></a>
@@ -57,7 +57,7 @@ The step's cache key, which names its entry file (`<directory>/<entry>.json` in
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1035)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1082)
 
 <a id="E2E_CacheInfo_Mode_"></a>
 <a id="E2E_CacheInfo_Mode"></a>
@@ -72,7 +72,7 @@ public required string Mode { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1018)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1065)
 
 <a id="E2E_CacheInfo_NotRecorded_"></a>
 <a id="E2E_CacheInfo_NotRecorded"></a>
@@ -89,7 +89,7 @@ public string? NotRecorded { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1032)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1079)
 
 <a id="E2E_CacheInfo_Reason_"></a>
 <a id="E2E_CacheInfo_Reason"></a>
@@ -104,7 +104,7 @@ public string? Reason { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1020)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1067)
 
 <a id="E2E_CacheInfo_RecordedBy_"></a>
 <a id="E2E_CacheInfo_RecordedBy"></a>
@@ -121,7 +121,7 @@ The configured model that recorded the entry a step replayed, as [Name](/api/E2E
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1038)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1085)
 
 <a id="E2E_CacheInfo_ReplayedActions_"></a>
 <a id="E2E_CacheInfo_ReplayedActions"></a>
@@ -138,7 +138,7 @@ The recorded actions the replay ran. 0 for a miss.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1023)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1070)
 
 <a id="E2E_CacheInfo_TotalActions_"></a>
 <a id="E2E_CacheInfo_TotalActions"></a>
@@ -155,4 +155,4 @@ The actions the recording holds. 0 when there was no recording to read.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1026)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1073)
diff --git a/docs-site/src/content/docs/api/E2E/CacheMode.md b/docs-site/src/content/docs/api/E2E/CacheMode.md
index 2b985d74..fab44c90 100644
--- a/docs-site/src/content/docs/api/E2E/CacheMode.md
+++ b/docs-site/src/content/docs/api/E2E/CacheMode.md
@@ -21,7 +21,7 @@ public enum CacheMode
 
 How the replay cache is used.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L878)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L934)
 
 ## Fields
 
@@ -39,7 +39,7 @@ Never read or write recordings.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L881)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L937)
 
 <a id="E2E_CacheMode_ReadOnly"></a>
 
@@ -55,7 +55,7 @@ Replay recordings, never write or delete them.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L884)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L940)
 
 <a id="E2E_CacheMode_ReadWrite"></a>
 
@@ -71,4 +71,4 @@ Replay recordings, record verified acts, and delete unverified ones.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L887)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L943)
diff --git a/docs-site/src/content/docs/api/E2E/E2EConfig.md b/docs-site/src/content/docs/api/E2E/E2EConfig.md
index e756db36..384547b7 100644
--- a/docs-site/src/content/docs/api/E2E/E2EConfig.md
+++ b/docs-site/src/content/docs/api/E2E/E2EConfig.md
@@ -62,7 +62,7 @@ public TimeSpan ActionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L90)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L106)
 
 <a id="E2E_E2EConfig_Agent_"></a>
 <a id="E2E_E2EConfig_Agent"></a>
@@ -79,7 +79,7 @@ The `default` agent. It always exists; its model may be null.
 
 **Value:** [AgentConfig](/api/E2E/AgentConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L103)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L119)
 
 <a id="E2E_E2EConfig_Agents_"></a>
 <a id="E2E_E2EConfig_Agents"></a>
@@ -94,7 +94,7 @@ public IReadOnlyDictionary<string, AgentConfig> Agents { get; }
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentConfig&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L100)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L116)
 
 <a id="E2E_E2EConfig_AssertionTimeout_"></a>
 <a id="E2E_E2EConfig_AssertionTimeout"></a>
@@ -109,7 +109,7 @@ public TimeSpan AssertionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L92)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L108)
 
 <a id="E2E_E2EConfig_Cache_"></a>
 <a id="E2E_E2EConfig_Cache"></a>
@@ -124,7 +124,7 @@ public CacheConfig Cache { get; }
 
 **Value:** [CacheConfig](/api/E2E/CacheConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L105)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L121)
 
 <a id="E2E_E2EConfig_Ci_"></a>
 <a id="E2E_E2EConfig_Ci"></a>
@@ -141,7 +141,7 @@ True when the `CI` environment variable is set to a true value.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L77)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L93)
 
 <a id="E2E_E2EConfig_CleanupTimeout_"></a>
 <a id="E2E_E2EConfig_CleanupTimeout"></a>
@@ -158,7 +158,7 @@ Engine shutdown timeout. Upstream `cleanupTimeout`, 30 s by default.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L95)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L111)
 
 <a id="E2E_E2EConfig_ConfigPath_"></a>
 <a id="E2E_E2EConfig_ConfigPath"></a>
@@ -175,7 +175,7 @@ The file this config was read from, or null for the defaults.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L71)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L87)
 
 <a id="E2E_E2EConfig_LaunchTimeout_"></a>
 <a id="E2E_E2EConfig_LaunchTimeout"></a>
@@ -192,7 +192,7 @@ Engine start timeout. Upstream `launchTimeout`, 60 s by default.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L88)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L104)
 
 <a id="E2E_E2EConfig_ProjectRoot_"></a>
 <a id="E2E_E2EConfig_ProjectRoot"></a>
@@ -209,7 +209,7 @@ The config file's directory. Relative paths such as `cache.dir` resolve against
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L74)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L90)
 
 <a id="E2E_E2EConfig_Retries_"></a>
 <a id="E2E_E2EConfig_Retries"></a>
@@ -226,7 +226,7 @@ public int Retries { get; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L98)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L114)
 
 <a id="E2E_E2EConfig_Secrets_"></a>
 <a id="E2E_E2EConfig_Secrets"></a>
@@ -241,7 +241,7 @@ public Secrets Secrets { get; }
 
 **Value:** [Secrets](/api/E2E/Secrets/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L107)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L123)
 
 <a id="E2E_E2EConfig_Target_"></a>
 <a id="E2E_E2EConfig_Target"></a>
@@ -258,7 +258,7 @@ The target a test runs on. The port runs one target.
 
 **Value:** [TargetConfig](/api/E2E/TargetConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L82)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L98)
 
 <a id="E2E_E2EConfig_Targets_"></a>
 <a id="E2E_E2EConfig_Targets"></a>
@@ -273,7 +273,7 @@ public IReadOnlyList<TargetConfig> Targets { get; }
 
 **Value:** [IReadOnlyList&lt;TargetConfig&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L79)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L95)
 
 <a id="E2E_E2EConfig_Timeout_"></a>
 <a id="E2E_E2EConfig_Timeout"></a>
@@ -290,7 +290,7 @@ Whole-test timeout. Upstream `timeout`, 120 s by default.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L85)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L101)
 
 ## Methods
 
@@ -316,7 +316,7 @@ The config with no file: upstream defaults, a `web` target with no URL, and no m
 
 **Returns:** [E2EConfig](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L136)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L152)
 
 <a id="E2E_E2EConfig_Discover_"></a>
 <a id="E2E_E2EConfig_Discover_System_Func_System_String_System_String__"></a>
@@ -340,7 +340,7 @@ above the working directory. Without one, returns `String%7d)` for the working d
 
 **Returns:** [E2EConfig](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L179)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L195)
 
 <a id="E2E_E2EConfig_Find_"></a>
 <a id="E2E_E2EConfig_Find_System_String___"></a>
@@ -365,7 +365,7 @@ looks for the file there and goes no higher.
 
 **Returns:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L147)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L163)
 
 <a id="E2E_E2EConfig_IsCi_"></a>
 <a id="E2E_E2EConfig_IsCi_System_Func_System_String_System_String__"></a>
@@ -388,7 +388,7 @@ True when `CI` is set to anything but empty, `0`, or `false`.
 
 **Returns:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L186)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L202)
 
 <a id="E2E_E2EConfig_Load_"></a>
 <a id="E2E_E2EConfig_Load_System_String_System_Func_System_String_System_String__"></a>
@@ -412,7 +412,7 @@ Reads and validates a config file. Throws [ConfigurationException](/api/E2E/Conf
 
 **Returns:** [E2EConfig](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L110)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L126)
 
 <a id="E2E_E2EConfig_Parse_"></a>
 <a id="E2E_E2EConfig_Parse_System_String_System_String_System_Func_System_String_System_String__"></a>
@@ -437,4 +437,4 @@ Validates config JSON. &lt;code class="paramref"&gt;projectRoot&lt;/code&gt; anc
 
 **Returns:** [E2EConfig](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L128)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L144)
diff --git a/docs-site/src/content/docs/api/E2E/E2EDefaults.md b/docs-site/src/content/docs/api/E2E/E2EDefaults.md
index c95241ce..8716cd10 100644
--- a/docs-site/src/content/docs/api/E2E/E2EDefaults.md
+++ b/docs-site/src/content/docs/api/E2E/E2EDefaults.md
@@ -108,6 +108,22 @@ Upstream `launchTimeout`.
 
 [View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EDefaults.cs#L17)
 
+<a id="E2E_E2EDefaults_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public const int MaxInputTokens = 64000
+```
+
+
+Upstream's `DEFAULT_INPUT_TOKENS`, the default of `maxInputTokens`: the input one model request may carry.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EDefaults.cs#L53)
+
 <a id="E2E_E2EDefaults_MaxModelCalls"></a>
 
 ### MaxModelCalls
@@ -124,6 +140,23 @@ Upstream `maxModelCalls` for one agent call.
 
 [View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EDefaults.cs#L41)
 
+<a id="E2E_E2EDefaults_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public const int MaxObservationBytes = 262144
+```
+
+
+Upstream's `DEFAULT_OBSERVATION_BYTES`, the default of `maxObservationBytes`. A quarter mebibyte of tree is already tens of
+thousands of tokens on every act turn; the per-call token ceiling clamps a dense screen below it.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EDefaults.cs#L50)
+
 <a id="E2E_E2EDefaults_MaxSteps"></a>
 
 ### MaxSteps
diff --git a/docs-site/src/content/docs/api/E2E/E2EFixture.md b/docs-site/src/content/docs/api/E2E/E2EFixture.md
index 3d489efd..12a87162 100644
--- a/docs-site/src/content/docs/api/E2E/E2EFixture.md
+++ b/docs-site/src/content/docs/api/E2E/E2EFixture.md
@@ -50,7 +50,7 @@ protected virtual TimeSpan ActionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L147)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L153)
 
 <a id="E2E_E2EFixture_Agent_"></a>
 <a id="E2E_E2EFixture_Agent"></a>
@@ -153,7 +153,7 @@ in the AI SDK devtools shape. The process writes them to `ai-trace-<process id>.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L138)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L144)
 
 <a id="E2E_E2EFixture_App_"></a>
 <a id="E2E_E2EFixture_App"></a>
@@ -183,7 +183,7 @@ protected virtual TimeSpan AssertionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L149)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L155)
 
 <a id="E2E_E2EFixture_BaseUrl_"></a>
 <a id="E2E_E2EFixture_BaseUrl"></a>
@@ -200,7 +200,7 @@ protected virtual string? BaseUrl { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L89)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L95)
 
 <a id="E2E_E2EFixture_Browser_"></a>
 <a id="E2E_E2EFixture_Browser"></a>
@@ -232,7 +232,7 @@ protected virtual string CacheDirectory { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L95)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L101)
 
 <a id="E2E_E2EFixture_CacheMode_"></a>
 <a id="E2E_E2EFixture_CacheMode"></a>
@@ -249,7 +249,7 @@ protected virtual CacheMode CacheMode { get; }
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L98)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L104)
 
 <a id="E2E_E2EFixture_CacheStrict_"></a>
 <a id="E2E_E2EFixture_CacheStrict"></a>
@@ -266,7 +266,7 @@ protected virtual bool CacheStrict { get; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L101)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L107)
 
 <a id="E2E_E2EFixture_CleanupTimeout_"></a>
 <a id="E2E_E2EFixture_CleanupTimeout"></a>
@@ -281,7 +281,7 @@ protected virtual TimeSpan CleanupTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L151)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L157)
 
 <a id="E2E_E2EFixture_Config_"></a>
 <a id="E2E_E2EFixture_Config"></a>
@@ -331,7 +331,7 @@ timings to stderr and keeps the transcript of every agent step. Override to turn
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L131)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L137)
 
 <a id="E2E_E2EFixture_JudgmentTimeout_"></a>
 <a id="E2E_E2EFixture_JudgmentTimeout"></a>
@@ -363,7 +363,24 @@ protected virtual TimeSpan LaunchTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L145)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L151)
+
+<a id="E2E_E2EFixture_MaxInputTokens_"></a>
+<a id="E2E_E2EFixture_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+protected virtual int MaxInputTokens { get; }
+```
+
+
+`agents.default.maxInputTokens`.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L89)
 
 <a id="E2E_E2EFixture_MaxModelCalls_"></a>
 <a id="E2E_E2EFixture_MaxModelCalls"></a>
@@ -380,7 +397,24 @@ protected virtual int MaxModelCalls { get; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L160)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L166)
+
+<a id="E2E_E2EFixture_MaxObservationBytes_"></a>
+<a id="E2E_E2EFixture_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+protected virtual int MaxObservationBytes { get; }
+```
+
+
+`agents.default.maxObservationBytes`.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L86)
 
 <a id="E2E_E2EFixture_MaxSteps_"></a>
 <a id="E2E_E2EFixture_MaxSteps"></a>
@@ -397,7 +431,7 @@ protected virtual int MaxSteps { get; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L163)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L169)
 
 <a id="E2E_E2EFixture_ProjectRoot_"></a>
 <a id="E2E_E2EFixture_ProjectRoot"></a>
@@ -414,7 +448,7 @@ Anchors the files a test names, such as a route's fulfill path. Defaults to the
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L92)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L98)
 
 <a id="E2E_E2EFixture_ProviderOptions_"></a>
 <a id="E2E_E2EFixture_ProviderOptions"></a>
@@ -431,7 +465,7 @@ protected virtual IReadOnlyDictionary<string, JsonElement>? ProviderOptions { ge
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L86)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L92)
 
 <a id="E2E_E2EFixture_ReplayTimeout_"></a>
 <a id="E2E_E2EFixture_ReplayTimeout"></a>
@@ -448,7 +482,7 @@ How long a replay waits for each recorded target and for the recorded end state.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L157)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L163)
 
 <a id="E2E_E2EFixture_ResultsDirectory_"></a>
 <a id="E2E_E2EFixture_ResultsDirectory"></a>
@@ -465,7 +499,7 @@ Where a failed screenshot comparison puts its diff, actual, and expected images.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L110)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L116)
 
 <a id="E2E_E2EFixture_RunAgent_"></a>
 <a id="E2E_E2EFixture_RunAgent"></a>
@@ -532,7 +566,7 @@ How long one `ActAsync` may run unless its options say otherwise. A .NET-only se
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L154)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L160)
 
 <a id="E2E_E2EFixture_TargetName_"></a>
 <a id="E2E_E2EFixture_TargetName"></a>
@@ -549,7 +583,7 @@ protected virtual string TargetName { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L113)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L119)
 
 <a id="E2E_E2EFixture_TestTimeout_"></a>
 <a id="E2E_E2EFixture_TestTimeout"></a>
@@ -564,7 +598,7 @@ protected virtual TimeSpan TestTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L143)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L149)
 
 <a id="E2E_E2EFixture_Trace_"></a>
 <a id="E2E_E2EFixture_Trace"></a>
@@ -582,7 +616,7 @@ protected virtual ResolvedRecording Trace { get; }
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L119)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L125)
 
 <a id="E2E_E2EFixture_UpdateSnapshots_"></a>
 <a id="E2E_E2EFixture_UpdateSnapshots"></a>
@@ -600,7 +634,7 @@ finds missing or different, and passes. Override to turn it on in code.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L107)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L113)
 
 <a id="E2E_E2EFixture_Video_"></a>
 <a id="E2E_E2EFixture_Video"></a>
@@ -618,7 +652,7 @@ protected virtual ResolvedRecording Video { get; }
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L125)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L131)
 
 ## Methods
 
@@ -645,7 +679,7 @@ Does nothing when setup never started a session.
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L233)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L251)
 
 <a id="E2E_E2EFixture_CreateAgents_"></a>
 <a id="E2E_E2EFixture_CreateAgents"></a>
@@ -746,7 +780,7 @@ an `Expect.Soft` failure to the framework (null keeps them on the session), and
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L174)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L180)
 
 <a id="E2E_E2EFixture_TakeSession_"></a>
 <a id="E2E_E2EFixture_TakeSession"></a>
@@ -763,4 +797,4 @@ Hands the running session to the adapter to complete and dispose, or null when s
 
 **Returns:** [E2ESession](/api/E2E/E2ESession/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L236)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L254)
diff --git a/docs-site/src/content/docs/api/E2E/E2ESession.md b/docs-site/src/content/docs/api/E2E/E2ESession.md
index 362e3d5a..e5394be9 100644
--- a/docs-site/src/content/docs/api/E2E/E2ESession.md
+++ b/docs-site/src/content/docs/api/E2E/E2ESession.md
@@ -222,7 +222,7 @@ looked at when the session is released. Only an attempt whose trace page is kept
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L584)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L588)
 
 <a id="E2E_E2ESession_CloseSoftFailures_"></a>
 <a id="E2E_E2ESession_CloseSoftFailures"></a>
@@ -242,7 +242,7 @@ matchers throw as hard ones would.
 
 **Returns:** [TestException](/api/E2E/TestException/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L331)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L333)
 
 <a id="E2E_E2ESession_Complete_"></a>
 <a id="E2E_E2ESession_Complete_System_Exception_System_Threading_CancellationToken_"></a>
@@ -269,7 +269,7 @@ rewritten. A model outage leaves existing entries in place, unless a failure on
 | `error` | [Exception](https://learn.microsoft.com/dotnet/api/system.exception) |  |
 | `cancellationToken` | [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) |  |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L341)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L343)
 
 <a id="E2E_E2ESession_DisposeAsync_"></a>
 <a id="E2E_E2ESession_DisposeAsync"></a>
@@ -287,7 +287,7 @@ resetting unmanaged resources asynchronously.
 
 **Returns:** [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask) — A task that represents the asynchronous dispose operation.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L360)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L362)
 
 <a id="E2E_E2ESession_Report_"></a>
 <a id="E2E_E2ESession_Report"></a>
diff --git a/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md b/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
index 5499db81..2ca9ebbc 100644
--- a/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
+++ b/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
@@ -23,7 +23,7 @@ How to open one [E2ESession](/api/E2E/E2ESession/). Retries set [Attempt](#E2E_E
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L805)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L810)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public TimeSpan ActionTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L883)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L894)
 
 <a id="E2E_E2ESessionOptions_Agent_"></a>
 <a id="E2E_E2ESessionOptions_Agent"></a>
@@ -57,7 +57,7 @@ The agent a call that names none uses, upstream's `agent` option of a test or ru
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L840)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L851)
 
 <a id="E2E_E2ESessionOptions_AgentContext_"></a>
 <a id="E2E_E2ESessionOptions_AgentContext"></a>
@@ -74,7 +74,7 @@ The default agent's upstream `context`: told to every model call, at most 16384
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L825)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L830)
 
 <a id="E2E_E2ESessionOptions_AgentExecutor_"></a>
 <a id="E2E_E2ESessionOptions_AgentExecutor"></a>
@@ -91,7 +91,7 @@ The default agent's custom brain, upstream's `executor`. See [Executor](/api/E2E
 
 **Value:** [IStepExecutor](/api/E2E/IStepExecutor/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L822)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L827)
 
 <a id="E2E_E2ESessionOptions_AgentSystem_"></a>
 <a id="E2E_E2ESessionOptions_AgentSystem"></a>
@@ -108,7 +108,7 @@ The default agent's upstream `system`: text appended to the act rules. Judges ne
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L816)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L821)
 
 <a id="E2E_E2ESessionOptions_AgentTools_"></a>
 <a id="E2E_E2ESessionOptions_AgentTools"></a>
@@ -125,7 +125,7 @@ The default agent's project tools, offered to the model beside the agent's own.
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentTool&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L819)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L824)
 
 <a id="E2E_E2ESessionOptions_Agents_"></a>
 <a id="E2E_E2ESessionOptions_Agents"></a>
@@ -143,7 +143,7 @@ Each starts from the built-in defaults, not from the default agent.
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentOptions&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L837)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L848)
 
 <a id="E2E_E2ESessionOptions_AiTrace_"></a>
 <a id="E2E_E2ESessionOptions_AiTrace"></a>
@@ -161,7 +161,7 @@ shape and added to `ai-trace-<process id>.json` next to the results directory (`
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L945)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L956)
 
 <a id="E2E_E2ESessionOptions_AssertionTimeout_"></a>
 <a id="E2E_E2ESessionOptions_AssertionTimeout"></a>
@@ -176,7 +176,7 @@ public TimeSpan AssertionTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L885)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L896)
 
 <a id="E2E_E2ESessionOptions_Attempt_"></a>
 <a id="E2E_E2ESessionOptions_Attempt"></a>
@@ -193,7 +193,7 @@ public int Attempt { get; init; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L951)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L962)
 
 <a id="E2E_E2ESessionOptions_BaseUrl_"></a>
 <a id="E2E_E2ESessionOptions_BaseUrl"></a>
@@ -208,7 +208,7 @@ public string? BaseUrl { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L845)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L856)
 
 <a id="E2E_E2ESessionOptions_Cache_"></a>
 <a id="E2E_E2ESessionOptions_Cache"></a>
@@ -223,7 +223,7 @@ public IStepCache? Cache { get; init; }
 
 **Value:** [IStepCache](/api/E2E/IStepCache/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L850)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L861)
 
 <a id="E2E_E2ESessionOptions_CacheEnabled_"></a>
 <a id="E2E_E2ESessionOptions_CacheEnabled"></a>
@@ -238,7 +238,7 @@ public bool CacheEnabled { get; init; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L852)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L863)
 
 <a id="E2E_E2ESessionOptions_CacheMode_"></a>
 <a id="E2E_E2ESessionOptions_CacheMode"></a>
@@ -255,7 +255,7 @@ public CacheMode CacheMode { get; init; }
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L855)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L866)
 
 <a id="E2E_E2ESessionOptions_CacheStrict_"></a>
 <a id="E2E_E2ESessionOptions_CacheStrict"></a>
@@ -274,7 +274,7 @@ Retries replay too, and the session never writes or deletes a recording, whateve
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L862)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L873)
 
 <a id="E2E_E2ESessionOptions_CleanupTimeout_"></a>
 <a id="E2E_E2ESessionOptions_CleanupTimeout"></a>
@@ -291,7 +291,7 @@ How long the engine may take to shut down on dispose. Upstream `cleanupTimeout`.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L868)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L879)
 
 <a id="E2E_E2ESessionOptions_Debug_"></a>
 <a id="E2E_E2ESessionOptions_Debug"></a>
@@ -309,7 +309,7 @@ and action phases, writes the table to stderr when it is released, and keeps eac
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L939)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L950)
 
 <a id="E2E_E2ESessionOptions_Engine_"></a>
 <a id="E2E_E2ESessionOptions_Engine"></a>
@@ -324,7 +324,7 @@ public required IEngine Engine { get; init; }
 
 **Value:** [IEngine](/api/E2E.Engine/IEngine/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L807)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L812)
 
 <a id="E2E_E2ESessionOptions_Judge_"></a>
 <a id="E2E_E2ESessionOptions_Judge"></a>
@@ -341,7 +341,7 @@ The default agent's judge for `assert`, `waitFor`, and `extract`. Defaults to [M
 
 **Value:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L813)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L818)
 
 <a id="E2E_E2ESessionOptions_JudgmentTimeout_"></a>
 <a id="E2E_E2ESessionOptions_JudgmentTimeout"></a>
@@ -358,7 +358,7 @@ The default agent's `judgmentTimeout`: the deadline of one `assert`, `waitFor`,
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L828)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L833)
 
 <a id="E2E_E2ESessionOptions_LaunchTimeout_"></a>
 <a id="E2E_E2ESessionOptions_LaunchTimeout"></a>
@@ -375,7 +375,24 @@ How long the engine may take to start. Upstream `launchTimeout`.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L865)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L876)
+
+<a id="E2E_E2ESessionOptions_MaxInputTokens_"></a>
+<a id="E2E_E2ESessionOptions_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public int MaxInputTokens { get; init; }
+```
+
+
+The default agent's `maxInputTokens`. See [MaxInputTokens](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxInputTokens).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L839)
 
 <a id="E2E_E2ESessionOptions_MaxModelCalls_"></a>
 <a id="E2E_E2ESessionOptions_MaxModelCalls"></a>
@@ -392,7 +409,24 @@ The default agent's model calls per agent call, 1 through 100.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L894)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L905)
+
+<a id="E2E_E2ESessionOptions_MaxObservationBytes_"></a>
+<a id="E2E_E2ESessionOptions_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public int MaxObservationBytes { get; init; }
+```
+
+
+The default agent's `maxObservationBytes`. See [MaxObservationBytes](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxObservationBytes).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L836)
 
 <a id="E2E_E2ESessionOptions_MaxSteps_"></a>
 <a id="E2E_E2ESessionOptions_MaxSteps"></a>
@@ -409,7 +443,7 @@ Actions one `ActAsync` may take, 1 through 100. [MaxSteps](/api/E2E/ActOptions/#
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L897)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L908)
 
 <a id="E2E_E2ESessionOptions_Model_"></a>
 <a id="E2E_E2ESessionOptions_Model"></a>
@@ -426,7 +460,7 @@ The default agent's model.
 
 **Value:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L810)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L815)
 
 <a id="E2E_E2ESessionOptions_OnSoftFailure_"></a>
 <a id="E2E_E2ESessionOptions_OnSoftFailure"></a>
@@ -444,7 +478,7 @@ on the session until [CloseSoftFailures()](/api/E2E/E2ESession/#E2E_E2ESession_C
 
 **Value:** [Action&lt;TestException&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L903)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L914)
 
 <a id="E2E_E2ESessionOptions_ProjectRoot_"></a>
 <a id="E2E_E2ESessionOptions_ProjectRoot"></a>
@@ -461,7 +495,7 @@ Anchors the files a test names, such as a route's fulfill `Path`. Defaults to th
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L848)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L859)
 
 <a id="E2E_E2ESessionOptions_ProviderOptions_"></a>
 <a id="E2E_E2ESessionOptions_ProviderOptions"></a>
@@ -478,7 +512,7 @@ The default agent's provider options, keyed by provider. See [ProviderOptions](/
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L831)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L842)
 
 <a id="E2E_E2ESessionOptions_ReplayTimeout_"></a>
 <a id="E2E_E2ESessionOptions_ReplayTimeout"></a>
@@ -495,7 +529,7 @@ How long a replay waits for each recorded target and for the recorded end state.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L891)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L902)
 
 <a id="E2E_E2ESessionOptions_ResultsDirectory_"></a>
 <a id="E2E_E2ESessionOptions_ResultsDirectory"></a>
@@ -512,7 +546,7 @@ Where a failed screenshot comparison puts its diff, actual, and expected images.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L921)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L932)
 
 <a id="E2E_E2ESessionOptions_StepTimeout_"></a>
 <a id="E2E_E2ESessionOptions_StepTimeout"></a>
@@ -529,7 +563,7 @@ How long one `ActAsync` may run unless [Timeout](/api/E2E/ActOptions/#E2E_ActOpt
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L888)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L899)
 
 <a id="E2E_E2ESessionOptions_TargetName_"></a>
 <a id="E2E_E2ESessionOptions_TargetName"></a>
@@ -546,7 +580,7 @@ The target's name in a stored screenshot's file name. Defaults to the engine's p
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L912)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L923)
 
 <a id="E2E_E2ESessionOptions_TestAgentContext_"></a>
 <a id="E2E_E2ESessionOptions_TestAgentContext"></a>
@@ -563,7 +597,7 @@ Upstream's `agentContext` of a test or group: appended to the context of every a
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L843)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L854)
 
 <a id="E2E_E2ESessionOptions_TestFailed_"></a>
 <a id="E2E_E2ESessionOptions_TestFailed"></a>
@@ -581,7 +615,7 @@ verifies acts, so a teardown assertion after a failure does not record them.
 
 **Value:** [Func&lt;bool&gt;](https://learn.microsoft.com/dotnet/api/system.func-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L909)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L920)
 
 <a id="E2E_E2ESessionOptions_TestFile_"></a>
 <a id="E2E_E2ESessionOptions_TestFile"></a>
@@ -602,7 +636,7 @@ alone as the identity and adds no title line, as for an `e2e mcp` session, which
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L879)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L890)
 
 <a id="E2E_E2ESessionOptions_TestTimeout_"></a>
 <a id="E2E_E2ESessionOptions_TestTimeout"></a>
@@ -617,7 +651,7 @@ public TimeSpan TestTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L881)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L892)
 
 <a id="E2E_E2ESessionOptions_TestTitle_"></a>
 <a id="E2E_E2ESessionOptions_TestTitle"></a>
@@ -632,7 +666,7 @@ public required string TestTitle { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L870)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L881)
 
 <a id="E2E_E2ESessionOptions_Trace_"></a>
 <a id="E2E_E2ESessionOptions_Trace"></a>
@@ -649,7 +683,7 @@ Which attempts record a trace. The session only carries the setting; [Attempt](#
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L930)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L941)
 
 <a id="E2E_E2ESessionOptions_UpdateSnapshots_"></a>
 <a id="E2E_E2ESessionOptions_UpdateSnapshots"></a>
@@ -667,7 +701,7 @@ different, and passes.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L918)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L929)
 
 <a id="E2E_E2ESessionOptions_Video_"></a>
 <a id="E2E_E2ESessionOptions_Video"></a>
@@ -684,4 +718,4 @@ Which attempts record a video. The session only carries the setting; [Attempt](#
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L944)
diff --git a/docs-site/src/content/docs/api/E2E/ExtractOptions.md b/docs-site/src/content/docs/api/E2E/ExtractOptions.md
index 2061289d..0311dbb8 100644
--- a/docs-site/src/content/docs/api/E2E/ExtractOptions.md
+++ b/docs-site/src/content/docs/api/E2E/ExtractOptions.md
@@ -24,7 +24,7 @@ public sealed class ExtractOptions
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L987)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1034)
 
 ## Properties
 
@@ -43,7 +43,7 @@ The named agent whose judge reads the screen. Defaults to `default`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L996)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1043)
 
 <a id="E2E_ExtractOptions_Timeout_"></a>
 <a id="E2E_ExtractOptions_Timeout"></a>
@@ -60,7 +60,7 @@ Defaults to the agent's `JudgmentTimeout` (30 s).
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L990)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1037)
 
 <a id="E2E_ExtractOptions_Vision_"></a>
 <a id="E2E_ExtractOptions_Vision"></a>
@@ -77,4 +77,4 @@ What the judge reads the data from. [Off](/api/E2E/VisionMode/#E2E_VisionMode_Of
 
 **Value:** [VisionMode](/api/E2E/VisionMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L993)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1040)
diff --git a/docs-site/src/content/docs/api/E2E/Locator.md b/docs-site/src/content/docs/api/E2E/Locator.md
index c3e80a81..5d4e5dc8 100644
--- a/docs-site/src/content/docs/api/E2E/Locator.md
+++ b/docs-site/src/content/docs/api/E2E/Locator.md
@@ -996,7 +996,7 @@ without the pointer having to hover it first. Both locators must come from the s
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L793)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L794)
 
 <a id="E2E_Locator_SelectOptionAsync_"></a>
 <a id="E2E_Locator_SelectOptionAsync_System_String_E2E_ActionOptions_System_Threading_CancellationToken_"></a>
diff --git a/docs-site/src/content/docs/api/E2E/LocatorExpression.md b/docs-site/src/content/docs/api/E2E/LocatorExpression.md
index d720173b..894a16fb 100644
--- a/docs-site/src/content/docs/api/E2E/LocatorExpression.md
+++ b/docs-site/src/content/docs/api/E2E/LocatorExpression.md
@@ -29,7 +29,7 @@ descendants of [Parent](#E2E_LocatorExpression_Parent) when it is set. `filter`
 
 **Implements:** [IEquatable&lt;LocatorExpression&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L998)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L999)
 
 ## Fields
 
@@ -45,7 +45,7 @@ public const int LastIndex = -1
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1000)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1001)
 
 ## Properties
 
@@ -62,7 +62,7 @@ public bool? Checked { get; init; }
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1017)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1018)
 
 <a id="E2E_LocatorExpression_Disabled_"></a>
 <a id="E2E_LocatorExpression_Disabled"></a>
@@ -77,7 +77,7 @@ public bool? Disabled { get; init; }
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1019)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1020)
 
 <a id="E2E_LocatorExpression_Exact_"></a>
 <a id="E2E_LocatorExpression_Exact"></a>
@@ -92,7 +92,7 @@ public bool Exact { get; init; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1013)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1014)
 
 <a id="E2E_LocatorExpression_Expanded_"></a>
 <a id="E2E_LocatorExpression_Expanded"></a>
@@ -107,7 +107,7 @@ public bool? Expanded { get; init; }
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1023)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1024)
 
 <a id="E2E_LocatorExpression_Has_"></a>
 <a id="E2E_LocatorExpression_Has"></a>
@@ -122,7 +122,7 @@ public LocatorExpression? Has { get; init; }
 
 **Value:** [LocatorExpression](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1039)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1040)
 
 <a id="E2E_LocatorExpression_HasText_"></a>
 <a id="E2E_LocatorExpression_HasText"></a>
@@ -137,7 +137,7 @@ public TextMatch? HasText { get; init; }
 
 **Value:** [TextMatch](/api/E2E/TextMatch/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1029)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1030)
 
 <a id="E2E_LocatorExpression_HasTextExact_"></a>
 <a id="E2E_LocatorExpression_HasTextExact"></a>
@@ -157,7 +157,7 @@ exactness of its own.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1037)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1038)
 
 <a id="E2E_LocatorExpression_Index_"></a>
 <a id="E2E_LocatorExpression_Index"></a>
@@ -172,7 +172,7 @@ public int? Index { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1041)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1042)
 
 <a id="E2E_LocatorExpression_Kind_"></a>
 <a id="E2E_LocatorExpression_Kind"></a>
@@ -187,7 +187,7 @@ public string Kind { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1006)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1007)
 
 <a id="E2E_LocatorExpression_Left_"></a>
 <a id="E2E_LocatorExpression_Left"></a>
@@ -202,7 +202,7 @@ public LocatorExpression? Left { get; init; }
 
 **Value:** [LocatorExpression](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1043)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1044)
 
 <a id="E2E_LocatorExpression_Level_"></a>
 <a id="E2E_LocatorExpression_Level"></a>
@@ -217,7 +217,7 @@ public int? Level { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1027)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1028)
 
 <a id="E2E_LocatorExpression_Parent_"></a>
 <a id="E2E_LocatorExpression_Parent"></a>
@@ -232,7 +232,7 @@ public LocatorExpression? Parent { get; init; }
 
 **Value:** [LocatorExpression](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1002)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1003)
 
 <a id="E2E_LocatorExpression_Pressed_"></a>
 <a id="E2E_LocatorExpression_Pressed"></a>
@@ -247,7 +247,7 @@ public bool? Pressed { get; init; }
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1025)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1026)
 
 <a id="E2E_LocatorExpression_Right_"></a>
 <a id="E2E_LocatorExpression_Right"></a>
@@ -262,7 +262,7 @@ public LocatorExpression? Right { get; init; }
 
 **Value:** [LocatorExpression](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1045)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1046)
 
 <a id="E2E_LocatorExpression_Role_"></a>
 <a id="E2E_LocatorExpression_Role"></a>
@@ -277,7 +277,7 @@ public string? Role { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1008)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1009)
 
 <a id="E2E_LocatorExpression_Selected_"></a>
 <a id="E2E_LocatorExpression_Selected"></a>
@@ -292,7 +292,7 @@ public bool? Selected { get; init; }
 
 **Value:** [bool?](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1021)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1022)
 
 <a id="E2E_LocatorExpression_Selector_"></a>
 <a id="E2E_LocatorExpression_Selector"></a>
@@ -309,7 +309,7 @@ The expression of a `selector` query, in the engine's own selector language. A d
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1048)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1049)
 
 <a id="E2E_LocatorExpression_Source_"></a>
 <a id="E2E_LocatorExpression_Source"></a>
@@ -324,7 +324,7 @@ public LocatorExpression? Source { get; init; }
 
 **Value:** [LocatorExpression](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1004)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1005)
 
 <a id="E2E_LocatorExpression_Value_"></a>
 <a id="E2E_LocatorExpression_Value"></a>
@@ -341,7 +341,7 @@ The role query's name, or the value every other query kind matches.
 
 **Value:** [TextMatch](/api/E2E/TextMatch/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1011)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1012)
 
 <a id="E2E_LocatorExpression_Visible_"></a>
 <a id="E2E_LocatorExpression_Visible"></a>
@@ -356,7 +356,7 @@ public bool Visible { get; init; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1015)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1016)
 
 ## Methods
 
@@ -373,4 +373,4 @@ public string Describe()
 
 **Returns:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1107)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L1115)
diff --git a/docs-site/src/content/docs/api/E2E/LocatorWaitForOptions.md b/docs-site/src/content/docs/api/E2E/LocatorWaitForOptions.md
index 5120b14e..c20d363f 100644
--- a/docs-site/src/content/docs/api/E2E/LocatorWaitForOptions.md
+++ b/docs-site/src/content/docs/api/E2E/LocatorWaitForOptions.md
@@ -23,7 +23,7 @@ Options for `CancellationToken)`.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L983)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L984)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public WaitForState State { get; init; }
 
 **Value:** [WaitForState](/api/E2E/WaitForState/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L985)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L986)
 
 <a id="E2E_LocatorWaitForOptions_Timeout_"></a>
 <a id="E2E_LocatorWaitForOptions_Timeout"></a>
@@ -57,4 +57,4 @@ How long to wait. Defaults to the configured action timeout.
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L988)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L989)
diff --git a/docs-site/src/content/docs/api/E2E/PressSequentiallyOptions.md b/docs-site/src/content/docs/api/E2E/PressSequentiallyOptions.md
index 40c84abe..1b8a714b 100644
--- a/docs-site/src/content/docs/api/E2E/PressSequentiallyOptions.md
+++ b/docs-site/src/content/docs/api/E2E/PressSequentiallyOptions.md
@@ -23,7 +23,7 @@ Options for `CancellationToken)`.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object) → [ActionOptions](/api/E2E/ActionOptions/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L960)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L961)
 
 ## Properties
 
@@ -42,4 +42,4 @@ How long to wait between characters.
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L963)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L964)
diff --git a/docs-site/src/content/docs/api/E2E/ScrollUntilVisibleOptions.md b/docs-site/src/content/docs/api/E2E/ScrollUntilVisibleOptions.md
index 146c66bc..9ec033e0 100644
--- a/docs-site/src/content/docs/api/E2E/ScrollUntilVisibleOptions.md
+++ b/docs-site/src/content/docs/api/E2E/ScrollUntilVisibleOptions.md
@@ -23,7 +23,7 @@ Options for `Screen.ScrollUntilVisibleAsync` and `Locator.ScrollUntilVisibleAsyn
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L945)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L946)
 
 ## Properties
 
@@ -42,7 +42,7 @@ Which way to scroll. Defaults to [Down](/api/E2E.Engine/ScrollDirection/#E2E_Eng
 
 **Value:** `ScrollDirection?`
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L950)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L951)
 
 <a id="E2E_ScrollUntilVisibleOptions_Momentum_"></a>
 <a id="E2E_ScrollUntilVisibleOptions_Momentum"></a>
@@ -59,7 +59,7 @@ The stride of each step. Defaults to [Slow](/api/E2E.Engine/Momentum/#E2E_Engine
 
 **Value:** `Momentum?`
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L953)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L954)
 
 <a id="E2E_ScrollUntilVisibleOptions_Timeout_"></a>
 <a id="E2E_ScrollUntilVisibleOptions_Timeout"></a>
@@ -76,4 +76,4 @@ How long to scroll before giving up, every swipe included. Defaults to 30 second
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L956)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L957)
diff --git a/docs-site/src/content/docs/api/E2E/TargetConfig.md b/docs-site/src/content/docs/api/E2E/TargetConfig.md
index 9d0dae7d..a9053dae 100644
--- a/docs-site/src/content/docs/api/E2E/TargetConfig.md
+++ b/docs-site/src/content/docs/api/E2E/TargetConfig.md
@@ -23,7 +23,7 @@ One entry of `targets`. The port drives the `web`, `ios`, and `android` platform
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L665)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L697)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public required AppConfig App { get; init; }
 
 **Value:** [AppConfig](/api/E2E/AppConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L671)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L703)
 
 <a id="E2E_TargetConfig_Name_"></a>
 <a id="E2E_TargetConfig_Name"></a>
@@ -55,7 +55,7 @@ public required string Name { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L667)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L699)
 
 <a id="E2E_TargetConfig_Platform_"></a>
 <a id="E2E_TargetConfig_Platform"></a>
@@ -70,7 +70,7 @@ public required string Platform { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L669)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L701)
 
 <a id="E2E_TargetConfig_Trace_"></a>
 <a id="E2E_TargetConfig_Trace"></a>
@@ -87,7 +87,7 @@ Which attempts write `trace.md`: `E2E_TRACE`, else this target's `trace`, else t
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L674)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L709)
 
 <a id="E2E_TargetConfig_Video_"></a>
 <a id="E2E_TargetConfig_Video"></a>
@@ -104,4 +104,4 @@ Which attempts record a video: `E2E_VIDEO`, else this target's `video`, else the
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L677)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L712)
diff --git a/docs-site/src/content/docs/api/E2E/WaitForOptions.md b/docs-site/src/content/docs/api/E2E/WaitForOptions.md
index 04025373..56d90cde 100644
--- a/docs-site/src/content/docs/api/E2E/WaitForOptions.md
+++ b/docs-site/src/content/docs/api/E2E/WaitForOptions.md
@@ -23,7 +23,7 @@ public sealed class WaitForOptions
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L965)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1012)
 
 ## Properties
 
@@ -42,7 +42,7 @@ The named agent whose judge decides. Defaults to `default`.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L980)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1027)
 
 <a id="E2E_WaitForOptions_Interval_"></a>
 <a id="E2E_WaitForOptions_Interval"></a>
@@ -59,7 +59,7 @@ Least time between two judgments, 100 ms through 60 s. Defaults to 3 s.
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L971)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1018)
 
 <a id="E2E_WaitForOptions_MaxModelCalls_"></a>
 <a id="E2E_WaitForOptions_MaxModelCalls"></a>
@@ -76,7 +76,7 @@ Model-call budget. Defaults to the configured `MaxModelCalls` and can only lower
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L974)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1021)
 
 <a id="E2E_WaitForOptions_Timeout_"></a>
 <a id="E2E_WaitForOptions_Timeout"></a>
@@ -93,7 +93,7 @@ Defaults to the agent's `JudgmentTimeout` (30 s).
 
 **Value:** [TimeSpan?](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L968)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1015)
 
 <a id="E2E_WaitForOptions_Vision_"></a>
 <a id="E2E_WaitForOptions_Vision"></a>
@@ -110,4 +110,4 @@ What the judge is shown. [Off](/api/E2E/VisionMode/#E2E_VisionMode_Off) by defau
 
 **Value:** [VisionMode](/api/E2E/VisionMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L977)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Agent.cs#L1024)
diff --git a/docs-site/src/content/docs/api/E2E/WaitForState.md b/docs-site/src/content/docs/api/E2E/WaitForState.md
index ac78b032..87e306c5 100644
--- a/docs-site/src/content/docs/api/E2E/WaitForState.md
+++ b/docs-site/src/content/docs/api/E2E/WaitForState.md
@@ -21,7 +21,7 @@ public enum WaitForState
 
 The state `CancellationToken)` waits for.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L967)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L968)
 
 ## Fields
 
@@ -39,7 +39,7 @@ Exactly one match, visible or not.
 
 **Value:** [WaitForState](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L973)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L974)
 
 <a id="E2E_WaitForState_Detached"></a>
 
@@ -55,7 +55,7 @@ No match, visible or not.
 
 **Value:** [WaitForState](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L976)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L977)
 
 <a id="E2E_WaitForState_Hidden"></a>
 
@@ -71,7 +71,7 @@ No visible match.
 
 **Value:** [WaitForState](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L979)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L980)
 
 <a id="E2E_WaitForState_Visible"></a>
 
@@ -87,4 +87,4 @@ Exactly one visible match.
 
 **Value:** [WaitForState](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L970)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Locator/Screen.cs#L971)
diff --git a/skills/e2e-dotnet/references/agent.md b/skills/e2e-dotnet/references/agent.md
index 3d449aec..e3900131 100644
--- a/skills/e2e-dotnet/references/agent.md
+++ b/skills/e2e-dotnet/references/agent.md
@@ -32,8 +32,21 @@ providers and their logins):
 ```
 
 - An agents entry takes `provider`, `model`, `judge`, `baseUrl`, `apiKeyEnv`,
-  `system`, `context`, `maxSteps`, `maxModelCalls`, `judgmentTimeout`, and
-  `providerOptions`. None inherits from `default`.
+  `system`, `context`, `maxSteps`, `maxModelCalls`, `judgmentTimeout`,
+  `maxObservationBytes`, `maxInputTokens`, and `providerOptions`. None inherits
+  from `default`.
+- `maxObservationBytes` (1024 through 16777216, default 262144) is the observation
+  payload ceiling for act turns and judgments. `maxInputTokens` (1 through
+  1000000, default 64000) is the input one model request may carry, counted in
+  UTF-8 bytes. A dense screen is cut to fit under it, with the marker
+  `[observation truncated at the resolved observation byte limit]` as its last
+  line, and the step's `observationTruncated` is set. The budget is the lower of
+  `maxObservationBytes` and `maxInputTokens` less what the rest of the request
+  costs (the system text, the context, the ledger, the instruction, and room for
+  a screenshot under `Vision`), and never under 1024 bytes. A judgment whose
+  request is still over `maxInputTokens` fails with `STEP_BUDGET_EXHAUSTED`
+  before it is sent. `AgentOptions`, `E2ESessionOptions`, and the fixture take
+  the same two values as `MaxObservationBytes` and `MaxInputTokens`.
 - `model` drives `ActAsync`. Judgments use `judge` when set, else `model`.
 - No model and no replay that finishes the step is `MODEL_UNAVAILABLE`, and so
   is a model GitHub Copilot does not serve to the account, at the first call.
@@ -462,8 +475,7 @@ own tools. A step that stays within the grammar verbs replays with no model
 call, so prefer the target's `App.BundleId` over `open_app` when every test
 starts in the same app. `samples/MobileApp.E2ETests` shows it in use.
 
-Not ported: decision models, `maxObservationBytes`,
-`maxInputTokens`, and the `--debug` agent step table. To see every model call, use
+Not ported: decision models and the `--debug` agent step table. To see every model call, use
 `E2E_AI_TRACE=1` (topic `debugging`).
 
 ## Custom executors
diff --git a/skills/e2e-dotnet/references/debugging.md b/skills/e2e-dotnet/references/debugging.md
index 0f3da1f0..a4d84564 100644
--- a/skills/e2e-dotnet/references/debugging.md
+++ b/skills/e2e-dotnet/references/debugging.md
@@ -228,7 +228,7 @@ failed before it read a screen has `observationRevision` `unrecorded`. See
 | `ACTION_MAY_HAVE_COMMITTED` | An action, scroll, key press, typing, or mouse call timed out, or hit a strict mode violation, after its input may have reached the page. On a device, a tap, key, swipe, or `Back` the device did not answer within `actionTimeout`. It is never repeated | Check the page state before you retry by hand |
 | `TIMEOUT` | `locator.WaitForAsync` timed out | Check the state you wait for |
 | `STEP_TIMEOUT`, `STEP_BUDGET_EXHAUSTED` | Goal too big or ambiguous, or a slow provider | Split the goal, use on-screen wording, add vocabulary in `context`; raise `maxSteps` or `maxModelCalls`, `StepTimeout`, or `judgmentTimeout` |
-| `CONTEXT_OVERFLOW` | The provider refused the model request as too large for its context window (`ActAsync` after one shrink-and-retry; a judgment on the first refusal) | Split the goal into smaller steps, or use a model with a larger context window |
+| `CONTEXT_OVERFLOW` | The provider refused the model request as too large for its context window (`ActAsync` after one shrink-and-retry; a judgment on the first refusal) | Lower `agents.<name>.maxObservationBytes`, split the goal into smaller steps, or use a model with a larger context window |
 | `REPLAY_STALE` | `cache.strict` is on and a committed recording no longer replays, or the cache directory holds the step's recording under another key (the message names the file and what changed since it was recorded: the engine contract, the replay policy, the agent's context) | Re-run once in `read-write` mode without `cache.strict` to re-record, then commit the changed entry. Delete the old file once nothing replays it |
 | `AUTOMATION_UNSUPPORTED` | The step needs an action the agent's tools lack (hover, drag) | Do that step with `Screen` actions |
 | `ENVIRONMENT_UNAVAILABLE` with "Chromium is not installed" or "could not install Chromium" | The browser install was skipped or failed | Allow network access for the first run, or run `e2e install` and set `E2E_SKIP_BROWSER_INSTALL=1` |
diff --git a/src/E2E/Agent/Act.cs b/src/E2E/Agent/Act.cs
index fae8576b..adaafc06 100644
--- a/src/E2E/Agent/Act.cs
+++ b/src/E2E/Agent/Act.cs
@@ -137,7 +137,19 @@ private async Task<ActResult> DispatchCoreAsync(StepSpec spec, ResolvedAgent age
         using var clock = new CancellationTokenSource(timeout);
         using var expiry = clock.Token.Register(() => budget.Fatalize(budget.TimedOut()));
         var token = stop.Token;
-        var feed = new ObservationFeed(_scope.Session, TimeProvider.System) { Scope = _scope };
+
+        // What every turn resends, which the observation is cut around: the context, the prior-step ledger, and the instruction.
+        var ledger = E2E.Ledger.SerializeLedger(E2E.Ledger.ProjectPriorSteps(_scope.Steps.Completed()), E2E.Ledger.MaxLedgerBytes);
+        var feed = new ObservationFeed(_scope.Session, TimeProvider.System)
+        {
+            Scope = _scope,
+            Options = new ObservationFeedOptions(
+                agent.MaxObservationBytes,
+                agent.MaxInputTokens,
+                ModelAdapter.TokenUpperBound(instruction),
+                agent.Context is null ? 0 : ModelAdapter.TokenUpperBound(agent.Context),
+                ledger.Bytes),
+        };
         _feed = feed;
         var stepIndex = _scope.NextStepIndex();
         _scope.Remember(spec.Params);
@@ -189,7 +201,7 @@ private async Task<ActResult> DispatchCoreAsync(StepSpec spec, ResolvedAgent age
 
             // The screen the step began on is stale once a replay acted, so the executor takes a fresh look.
             var prefix = session?.ReplayedPrefix;
-            context = new ActContext(_scope, feed, budget, dispatcher, spec, agent, stepIndex, declared, prefix is not null && recorder.RecordedCount > 0 ? null : start, prefix);
+            context = new ActContext(_scope, feed, budget, dispatcher, spec, agent, stepIndex, declared, ledger, prefix is not null && recorder.RecordedCount > 0 ? null : start, prefix);
             StepVerdict verdict;
             try
             {
diff --git a/src/E2E/Agent/ActContext.cs b/src/E2E/Agent/ActContext.cs
index fb8993eb..52fb82b2 100644
--- a/src/E2E/Agent/ActContext.cs
+++ b/src/E2E/Agent/ActContext.cs
@@ -55,7 +55,7 @@ internal sealed partial class ActContext : StepExecutorContext
     private const int MaxOutcomeChars = 2048;
 
     [SetsRequiredMembers]
-    public ActContext(AttemptScope scope, ObservationFeed feed, StepAccounting budget, ActionDispatcher dispatcher, StepSpec spec, ResolvedAgent agent, int stepIndex, IReadOnlyList<Secret> declared, Observation? start, ReplayedPrefix? prefix)
+    public ActContext(AttemptScope scope, ObservationFeed feed, StepAccounting budget, ActionDispatcher dispatcher, StepSpec spec, ResolvedAgent agent, int stepIndex, IReadOnlyList<Secret> declared, LedgerContext ledger, Observation? start, ReplayedPrefix? prefix)
     {
         _scope = scope;
         _feed = feed;
@@ -81,14 +81,13 @@ public ActContext(AttemptScope scope, ObservationFeed feed, StepAccounting budge
         ReplayedPrefix = prefix;
         Model = agent.Model;
         ProviderOptions = agent.ProviderOptions;
-        var ledger = E2E.Ledger.SerializeLedger(E2E.Ledger.ProjectPriorSteps(scope.Steps.Completed()), E2E.Ledger.MaxLedgerBytes);
         Ledger = ledger.Text;
         LedgerBytes = ledger.Bytes;
         AgentContext = agent.Context is null ? null : scope.Redactor.Redact(agent.Context);
         Budgets = budget;
         Actions = dispatcher;
         Host = new ActHost(scope, feed, budget, spec.Params);
-        Start = start is null ? null : ObservationFeed.View(start, scope);
+        Start = start is null ? null : feed.View(start, scope);
     }
 
     /// <summary>Bytes of <see cref="StepExecutorContext.Ledger"/>, which the step's metrics keep.</summary>
diff --git a/src/E2E/Agent/ActTools.cs b/src/E2E/Agent/ActTools.cs
index c4b6e3ba..3244c4db 100644
--- a/src/E2E/Agent/ActTools.cs
+++ b/src/E2E/Agent/ActTools.cs
@@ -377,7 +377,7 @@ private async Task<ToolOutcome> DescribeOutcomeAsync(string action, Cancellation
     private async Task<string> DescribeAsync(string action, CancellationToken token)
     {
         var observation = await _feed.ObserveAsync(SettleMode.HeldStill, token).ConfigureAwait(false);
-        return action + "\n" + SnapshotText.Render(observation, _scope.Redactor, _scope.AppOrigin);
+        return action + "\n" + _feed.Text(observation);
     }
 
     // A name the engine cut at its limit can end with the leading part of a secret, so it is redacted as a cut field.
diff --git a/src/E2E/Agent/Agent.cs b/src/E2E/Agent/Agent.cs
index d4ca36d0..66a72bbe 100644
--- a/src/E2E/Agent/Agent.cs
+++ b/src/E2E/Agent/Agent.cs
@@ -117,7 +117,7 @@ async Task<Look> ObserveAsync()
         {
             try
             {
-                return await LookAsync("agent.waitFor", vision, token).ConfigureAwait(false);
+                return await LookAsync("agent.waitFor", vision, agent, JudgeSystemFor(agent), statement, token).ConfigureAwait(false);
             }
             catch (Exception ex) when (ex is not AgentException
                 && (linked.IsCancellationRequested || DateTime.UtcNow >= deadline)
@@ -203,7 +203,7 @@ private async Task<T> ExtractCoreAsync<T>(string instruction, ExtractOptions? op
         var vision = ResolveVision(options?.Vision ?? VisionMode.Off);
         using var linked = Link(cancellationToken, ResolveTimeout(options?.Timeout, agent.JudgmentTimeout));
         var token = linked.Token;
-        var look = await LookAsync("agent.extract", vision, token).ConfigureAwait(false);
+        var look = await LookAsync("agent.extract", vision, agent, ExtractSystemFor(agent), instruction, token).ConfigureAwait(false);
         var schema = JsonSchemaExporter.GetJsonSchemaAsNode(ExtractSchemaJson, typeof(T), ExtractSchemaOptions);
         var tools = AgentTools.ExtractFor(schema);
         var messages = new List<ModelMessage>
@@ -286,7 +286,7 @@ private async Task JudgeAsync(string statement, TimeSpan timeout, ResolvedAgent
     {
         using var linked = Link(cancellationToken, timeout);
         var token = linked.Token;
-        var look = await LookAsync("agent.assert", vision, token).ConfigureAwait(false);
+        var look = await LookAsync("agent.assert", vision, agent, JudgeSystemFor(agent), statement, token).ConfigureAwait(false);
         var verdict = await JudgeOnceAsync(statement, look, agent, JudgmentModelCalls, token, cancellationToken).ConfigureAwait(false);
 
         // The redacted screenshot is kept whenever Screenshot allows it, on a passing judgment too.
@@ -343,6 +343,50 @@ private sealed record Look(string Tree, ModelImage? Image, string Text, string S
         public IReadOnlyList<ModelImage>? Images => Image is null ? null : [Image];
     }
 
+    /// <summary>
+    /// Bytes one observation may contribute to a judgment's request (upstream's <c>observationByteBudget</c> in <c>agent/invocation.ts</c>).
+    /// Under <see cref="VisionMode.Only"/> nothing of the tree reaches the request, so the per-call token ceiling does not bind it: the
+    /// configured ceiling still bounds the walk.
+    /// </summary>
+    private int ObservationByteBudget(ResolvedAgent agent, string system, string instruction, VisionMode vision) =>
+        vision == VisionMode.Only
+            ? agent.MaxObservationBytes
+            : ObservationBudget.ObservationByteBudget(
+                new ObservationBudgetLimits(agent.MaxObservationBytes, agent.MaxInputTokens),
+                new ObservationBudgetRequest(
+                    ModelAdapter.TokenUpperBound(_scope.Redactor.Redact(system)),
+                    ModelAdapter.TokenUpperBound(_scope.Redactor.Redact(instruction)),
+                    vision != VisionMode.Off));
+
+    /// <summary>
+    /// The model adapter's pre-flight (upstream's <c>sdk.ts</c>): the request's input upper bound against the agent's
+    /// <c>maxInputTokens</c>, so unavailable accounting fails before the request is sent.
+    /// </summary>
+    private static void CheckInputBound(string system, IReadOnlyList<ModelMessage> messages, int maxInputTokens)
+    {
+        long bound = ModelAdapter.TokenUpperBound(system);
+        foreach (var message in messages)
+        {
+            bound += message.Content is null ? 0 : ModelAdapter.TokenUpperBound(message.Content);
+            foreach (var call in message.ToolCalls ?? [])
+            {
+                bound += ModelAdapter.TokenUpperBound(call.Arguments.GetRawText());
+            }
+
+            foreach (var image in message.Images ?? [])
+            {
+                bound += ModelAdapter.ImageTokenUpperBound(image.Width, image.Height);
+            }
+        }
+
+        if (bound > maxInputTokens)
+        {
+            throw new AgentException(
+                "STEP_BUDGET_EXHAUSTED",
+                "model input upper bound " + bound.ToString(CultureInfo.InvariantCulture) + " exceeds the agent's maxInputTokens " + maxInputTokens.ToString(CultureInfo.InvariantCulture));
+        }
+    }
+
     private static VisionMode ResolveVision(VisionMode vision)
     {
         return Enum.IsDefined(vision) ? vision : throw new TestException("INVALID_ARGUMENT", "vision must be Off, On, or Only");
@@ -352,7 +396,7 @@ private static VisionMode ResolveVision(VisionMode vision)
     /// Captures one fresh look. A tainted attempt, a capture the engine cannot make, and masking the engine cannot prove
     /// each degrade the call to the tree alone, except under <see cref="VisionMode.Only"/>, which fails.
     /// </summary>
-    private async Task<Look> LookAsync(string api, VisionMode vision, CancellationToken token)
+    private async Task<Look> LookAsync(string api, VisionMode vision, ResolvedAgent agent, string system, string instruction, CancellationToken token)
     {
         var tainted = vision != VisionMode.Off && _scope.Exposure.WithholdsModelPixels;
         if (tainted)
@@ -361,20 +405,21 @@ private async Task<Look> LookAsync(string api, VisionMode vision, CancellationTo
         }
 
         // The look and the tree a model reads of it are one phase, whose event tells the nodes read and the bytes of that tree.
-        var (observation, tree) = await Phases.InstrumentPhaseAsync(
+        var (observation, tree, cut) = await Phases.InstrumentPhaseAsync(
             new PhaseHost(_scope.Steps, _scope.Debug),
             new PhaseSpec(StepEventKind.Observation, Phases.Observe),
             async () =>
             {
                 var seen = await _scope.ObserveAsync(token).ConfigureAwait(false);
-                return (Seen: seen, Tree: SnapshotText.Render(seen, _scope.Redactor, _scope.AppOrigin));
+                var text = SnapshotText.Render(seen, _scope.Redactor, _scope.AppOrigin, ObservationByteBudget(agent, system, instruction, vision), out var overBudget);
+                return (Seen: seen, Tree: text, Cut: overBudget);
             },
             look => new PhaseDetail(LocatorResolver.Walk(look.Seen.Roots).Count(), System.Text.Encoding.UTF8.GetByteCount(look.Tree))).ConfigureAwait(false);
 
         // Bytes the request carries, so a tree the call withholds reads as the zero it is.
         _scope.Steps.AttachAgentDetails(new StepAgentDetails
         {
-            ObservationTruncated = observation.Truncated ? true : null,
+            ObservationTruncated = observation.Truncated || cut ? true : null,
             ObservationRevision = observation.Revision.Length > 0 ? observation.Revision : null,
             ObservationBytes = vision == VisionMode.Only ? null : System.Text.Encoding.UTF8.GetByteCount(tree),
         });
@@ -701,13 +746,15 @@ internal async Task<ModelResponse> CallModelAsync(
             throw new AgentException("MODEL_UNAVAILABLE", "No model is configured. Agent steps need an IAgentModel, or a replay that finishes on its own.");
         }
 
+        var redactedSystem = _scope.Redactor.Redact(system);
+        CheckInputBound(redactedSystem, messages, agent.MaxInputTokens);
         ModelResponse response;
         var started = DateTimeOffset.UtcNow;
         try
         {
             var request = new ModelRequest
             {
-                System = _scope.Redactor.Redact(system),
+                System = redactedSystem,
                 Messages = messages,
                 Tools = tools,
                 ProviderOptions = agent.ProviderOptions,
diff --git a/src/E2E/Agent/AgentObservation.cs b/src/E2E/Agent/AgentObservation.cs
index 71a0ef01..23fa14ff 100644
--- a/src/E2E/Agent/AgentObservation.cs
+++ b/src/E2E/Agent/AgentObservation.cs
@@ -57,10 +57,6 @@ internal static class AgentObservation
 
     private static readonly HashSet<string> EmptyRoots = new(["document", "screen", "window"], StringComparer.Ordinal);
 
-    /// <summary>The size in bytes of the screen as a model reads it (upstream's <c>observation.bytes</c>).</summary>
-    public static int Bytes(Observation observation, Redactor redactor, string? appOrigin) =>
-        Encoding.UTF8.GetByteCount(SnapshotText.Render(observation, redactor, appOrigin));
-
     /// <summary>
     /// The shape two looks are compared by: the screen as the model reads it, without the per-observation node
     /// references, without focus, which moves without the page changing, and with clock-like values read as one
diff --git a/src/E2E/Agent/AgentOptions.cs b/src/E2E/Agent/AgentOptions.cs
index 8013cb18..12abf86e 100644
--- a/src/E2E/Agent/AgentOptions.cs
+++ b/src/E2E/Agent/AgentOptions.cs
@@ -54,6 +54,19 @@ public sealed class AgentOptions
     /// <summary>Deadline of one <c>assert</c>, <c>waitFor</c>, or <c>extract</c>.</summary>
     public TimeSpan JudgmentTimeout { get; init; } = E2EDefaults.JudgmentTimeout;
 
+    /// <summary>
+    /// The most bytes of the screen one model request carries, upstream's <c>maxObservationBytes</c>, 1024 through 16777216. A
+    /// screen over it is cut and ends with a marker. The per-call <see cref="MaxInputTokens"/> ceiling binds first on a large screen.
+    /// </summary>
+    public int MaxObservationBytes { get; init; } = E2EDefaults.MaxObservationBytes;
+
+    /// <summary>
+    /// The input one model request of this agent may carry, upstream's <c>maxInputTokens</c>, 1 through 1000000, counted as upstream's
+    /// <c>tokenUpperBound</c> does: in UTF-8 bytes. The screen is cut to fit under it, and a judgment whose request is over it fails
+    /// with <c>STEP_BUDGET_EXHAUSTED</c> before it is sent.
+    /// </summary>
+    public int MaxInputTokens { get; init; } = E2EDefaults.MaxInputTokens;
+
     /// <summary>
     /// Provider options every model call carries, keyed by provider. <see cref="OpenAiCompatibleModel"/>
     /// adds the fields under its <see cref="OpenAiCompatibleModelOptions.Provider"/> key to the request body as given.
@@ -76,6 +89,15 @@ internal sealed class ResolvedAgent
     /// <summary>The largest <c>maxSteps</c> and <c>maxModelCalls</c> an agent may configure.</summary>
     public const int MaxBudget = 100;
 
+    /// <summary>The smallest <c>maxObservationBytes</c> an agent may configure (1 KiB).</summary>
+    public const int MinObservationBytes = 1_024;
+
+    /// <summary>The largest <c>maxObservationBytes</c> an agent may configure (16 MiB).</summary>
+    public const int MaxObservationBytesLimit = 16_777_216;
+
+    /// <summary>The largest <c>maxInputTokens</c> an agent may configure.</summary>
+    public const int MaxInputTokensLimit = 1_000_000;
+
     public required string Name { get; init; }
 
     public IAgentModel? Model { get; init; }
@@ -95,10 +117,32 @@ internal sealed class ResolvedAgent
 
     public TimeSpan JudgmentTimeout { get; init; } = E2EDefaults.JudgmentTimeout;
 
+    public int MaxObservationBytes { get; init; } = E2EDefaults.MaxObservationBytes;
+
+    public int MaxInputTokens { get; init; } = E2EDefaults.MaxInputTokens;
+
     public IReadOnlyDictionary<string, JsonElement>? ProviderOptions { get; init; }
 
     public IReadOnlyDictionary<string, AgentTool>? Tools { get; init; }
 
+    /// <summary>
+    /// The run's limits over its configured agents (upstream's <c>runLimits</c>, <c>config/agent.ts</c>). A pinned agent's calls are bounded
+    /// by its own values, so the run-level number is the largest any agent may use: the report must not read lower than what a step could
+    /// actually send. Without agents the limits are the defaults.
+    /// </summary>
+    internal static ReportLimits RunLimits(IEnumerable<ResolvedAgent> agents)
+    {
+        ArgumentNullException.ThrowIfNull(agents);
+        var all = agents.ToList();
+        return all.Count == 0
+            ? ReportLimits.Default
+            : ReportLimits.Default with
+            {
+                MaxObservationBytes = all.Max(agent => agent.MaxObservationBytes),
+                MaxModelTokensPerCall = all.Max(agent => agent.MaxInputTokens),
+            };
+    }
+
     /// <summary>
     /// This agent with the test's <c>agentContext</c> joined into its <see cref="Context"/>: the agent's own context, then the
     /// test's, one per line. A blank part is left out. The test's title is not part of the context: it opens the user message.
@@ -117,6 +161,8 @@ public ResolvedAgent WithTestContext(string? testContext)
             MaxSteps = MaxSteps,
             MaxModelCalls = MaxModelCalls,
             JudgmentTimeout = JudgmentTimeout,
+            MaxObservationBytes = MaxObservationBytes,
+            MaxInputTokens = MaxInputTokens,
             ProviderOptions = ProviderOptions,
             Tools = Tools,
         };
@@ -141,6 +187,8 @@ public static ResolvedAgent From(string name, AgentOptions options)
             throw new ConfigurationException("INVALID_CONFIG", label + ".judgmentTimeout must be a positive integer of milliseconds");
         }
 
+        Check(options.MaxObservationBytes, label + ".maxObservationBytes", MinObservationBytes, MaxObservationBytesLimit);
+        Check(options.MaxInputTokens, label + ".maxInputTokens", 1, MaxInputTokensLimit);
         CheckContext(options.Context, label + ".context");
         CheckProviderOptions(options.ProviderOptions, label);
         CheckTools(options.Tools, label);
@@ -157,6 +205,8 @@ public static ResolvedAgent From(string name, AgentOptions options)
             MaxSteps = options.MaxSteps ?? E2EDefaults.MaxSteps,
             MaxModelCalls = options.MaxModelCalls ?? E2EDefaults.MaxModelCalls,
             JudgmentTimeout = options.JudgmentTimeout,
+            MaxObservationBytes = options.MaxObservationBytes,
+            MaxInputTokens = options.MaxInputTokens,
             ProviderOptions = options.ProviderOptions,
             Tools = options.Tools,
         };
@@ -214,13 +264,16 @@ public static ResolvedAgent From(string name, AgentOptions options)
     internal static AgentException MissingModelError(string name, string needs = "the agent fixture requires a model") =>
         new("MODEL_UNAVAILABLE", needs + ", and agents." + name + " has none: set Model on it to an IAgentModel, or model and provider in e2e.config.json");
 
-    internal static void Check(int value, string label)
+    internal static void Check(int value, string label) => Check(value, label, 1, MaxBudget);
+
+    /// <summary>Upstream's <c>boundedInt</c>: an integer within [<paramref name="min"/>, <paramref name="max"/>].</summary>
+    internal static void Check(int value, string label, int min, int max)
     {
-        if (value is < 1 or > MaxBudget)
+        if (value < min || value > max)
         {
             throw new ConfigurationException(
                 "INVALID_CONFIG",
-                label + " must be an integer from 1 to " + MaxBudget.ToString(CultureInfo.InvariantCulture));
+                label + " must be an integer from " + min.ToString(CultureInfo.InvariantCulture) + " through " + max.ToString(CultureInfo.InvariantCulture));
         }
     }
 
diff --git a/src/E2E/Agent/Model.cs b/src/E2E/Agent/Model.cs
index 4f845451..b6e975f3 100644
--- a/src/E2E/Agent/Model.cs
+++ b/src/E2E/Agent/Model.cs
@@ -185,3 +185,24 @@ public Task<ModelResponse> CompleteAsync(ModelRequest request, CancellationToken
         return Task.FromResult(_next(request));
     }
 }
+
+/// <summary>The input bounds of upstream's <c>agent/model/adapter.ts</c>, which the observation budget and the judgment pre-flight share.</summary>
+internal static class ModelAdapter
+{
+    /// <summary>Side of the square patch tile-based vision encoders consume an image in.</summary>
+    private const int ImageTilePx = 28;
+
+    /// <summary>
+    /// Conservative token upper bound. UTF-8 byte length bounds every byte-level tokenizer from above, so it is used when a provider
+    /// reports no usage and for the pre-flight ceiling. Every budget that mixes with this one (reserves, ledger size, observation size)
+    /// is therefore in the same byte-scaled units, not in real tokens.
+    /// </summary>
+    public static int TokenUpperBound(string text) => System.Text.Encoding.UTF8.GetByteCount(text);
+
+    /// <summary>
+    /// Conservative token bound for one image: vision providers bill images by fixed-size patches rather than bytes, so the count of
+    /// patches covering the image bounds every such encoder from above.
+    /// </summary>
+    public static int ImageTokenUpperBound(int width, int height) =>
+        (int)Math.Ceiling(Math.Max(1, width) / (double)ImageTilePx) * (int)Math.Ceiling(Math.Max(1, height) / (double)ImageTilePx);
+}
diff --git a/src/E2E/Agent/ObservationBudget.cs b/src/E2E/Agent/ObservationBudget.cs
new file mode 100644
index 00000000..fd6ee9b2
--- /dev/null
+++ b/src/E2E/Agent/ObservationBudget.cs
@@ -0,0 +1,53 @@
+// Copyright 2026 TesterArmy.
+// Modified by Dario Kondratiuk.
+// SPDX-License-Identifier: Apache-2.0
+
+namespace E2E;
+
+/// <summary>What <see cref="ObservationBudget.ObservationByteBudget"/> reads of the agent's limits (upstream's <c>ObservationBudgetLimits</c>).</summary>
+/// <param name="MaxObservationBytes"><c>agent.maxObservationBytes</c>: the configured ceiling.</param>
+/// <param name="MaxInputTokens"><c>agent.maxInputTokens</c>: the per-call ceiling the model pre-flight checks.</param>
+internal readonly record struct ObservationBudgetLimits(int MaxObservationBytes, int MaxInputTokens);
+
+/// <summary>What <see cref="ObservationBudget.ObservationByteBudget"/> reads of the request (upstream's <c>ObservationBudgetRequest</c>).</summary>
+/// <param name="FixedBytes">Bytes the rest of the request already costs: system message, ledger, context.</param>
+/// <param name="InstructionBytes">Bytes of the caller's instruction as the prompt carries it; 0 when it is not sent with the observation.</param>
+/// <param name="Pixels">Whether a screenshot travels with the tree, reserving its token cost too.</param>
+internal readonly record struct ObservationBudgetRequest(int FixedBytes, int InstructionBytes, bool Pixels);
+
+/// <summary>
+/// The observation byte budget both agent tiers capture under (upstream's <c>agent/observation-budget.ts</c>). The judgment tier
+/// derived it first; the act loop reuses it so a dense page costs the same bounded slice of the per-call token ceiling in either path.
+/// </summary>
+internal static class ObservationBudget
+{
+    /// <summary>
+    /// Headroom reserved for what travels with the instruction, in the byte-scaled units <see cref="ModelAdapter.TokenUpperBound"/> works in:
+    /// the request text, the prompt's markup, and a repair section quoting a rejected response. The instruction itself is measured, not
+    /// reserved for: a long extract instruction outgrows any fixed figure, and the pre-flight refuses the request instead of the screen
+    /// being cut to fit.
+    /// </summary>
+    private const int InstructionReserve = 4_096;
+
+    /// <summary>
+    /// Headroom reserved for one attached screenshot on a vision call, in the same units. The exact cost is only known once the
+    /// observation reports its viewport, which is after the budget has to be fixed, so this reserves for the largest viewport worth
+    /// planning for, derived through the same function the pre-flight bills with.
+    /// </summary>
+    private static readonly int PixelReserve = ModelAdapter.ImageTokenUpperBound(2_560, 1_440);
+
+    /// <summary>Floor below which a clamped budget never falls; a tree this small still names the visible controls.</summary>
+    private const int MinObservationBytes = 1_024;
+
+    /// <summary>
+    /// Bytes one observation may contribute to a request. <c>agent.maxObservationBytes</c> is the configured ceiling, but the per-call
+    /// token limit binds first on a large screen. Deriving the budget from what the rest of the request actually costs makes a big screen
+    /// truncate visibly rather than fail the pre-flight check.
+    /// </summary>
+    public static int ObservationByteBudget(ObservationBudgetLimits limits, ObservationBudgetRequest request)
+    {
+        var overhead = (long)request.FixedBytes + request.InstructionBytes + InstructionReserve + (request.Pixels ? PixelReserve : 0);
+        var withinTokenCeiling = Math.Max(MinObservationBytes, limits.MaxInputTokens - overhead);
+        return (int)Math.Min(limits.MaxObservationBytes, withinTokenCeiling);
+    }
+}
diff --git a/src/E2E/Agent/ObservationFeed.cs b/src/E2E/Agent/ObservationFeed.cs
index ce647254..21e88a3c 100644
--- a/src/E2E/Agent/ObservationFeed.cs
+++ b/src/E2E/Agent/ObservationFeed.cs
@@ -15,6 +15,9 @@ namespace E2E;
 /// </summary>
 internal sealed class ObservationFeed(IEngineSession session, TimeProvider time)
 {
+    // Whether the executor-facing look in flight asked for pixels, which reserve part of the token ceiling the tree is cut under.
+    private bool _pixels;
+
     private readonly Dictionary<string, SemanticNode> _seen = [];
     private PendingChange? _pending;
 
@@ -27,6 +30,12 @@ internal sealed class ObservationFeed(IEngineSession session, TimeProvider time)
     /// <summary>The step's observation record for the report (upstream's <c>reportDetails</c>).</summary>
     public StepAgentDetails ReportDetails() => new() { ObservationTruncated = _observationTruncated ? true : null };
 
+    /// <summary>
+    /// The limits the step's observations are cut under, upstream's <c>ObservationFeedOptions</c>. Null for a feed that cuts nothing,
+    /// such as a judgment's.
+    /// </summary>
+    public ObservationFeedOptions? Options { get; init; }
+
     /// <summary>The newest observation of the step, if any was captured.</summary>
     public Observation? Latest { get; private set; }
 
@@ -68,7 +77,7 @@ private PhaseDetail Book(Observation observation)
             return new PhaseDetail(count);
         }
 
-        var bytes = AgentObservation.Bytes(observation, scope.Redactor, scope.AppOrigin);
+        var bytes = System.Text.Encoding.UTF8.GetByteCount(Text(observation, _pixels));
         MaxObservationBytes = Math.Max(MaxObservationBytes, bytes);
         return new PhaseDetail(count, bytes);
     }
@@ -141,7 +150,17 @@ private async Task<Observation> LookAsync(SettleMode mode, CancellationToken tok
     public async Task<ExecutorObservation> ObserveAsync(ExecutorObserveOptions? options, CancellationToken token)
     {
         var scope = Scope ?? throw new InvalidOperationException("This feed serves no executor.");
-        var observation = await ObserveAsync(SettleMode.HeldStill, token).ConfigureAwait(false);
+        _pixels = options?.Pixels == true;
+        Observation observation;
+        try
+        {
+            observation = await ObserveAsync(SettleMode.HeldStill, token).ConfigureAwait(false);
+        }
+        finally
+        {
+            _pixels = false;
+        }
+
         var view = View(observation, scope, options);
         if (options?.Pixels != true)
         {
@@ -165,14 +184,51 @@ public async Task<ExecutorObservation> ObserveAsync(ExecutorObserveOptions? opti
     /// Upstream's <c>view</c>: one capture as the executor sees it, redacted, with the text, the truncation, the keyboard state
     /// and the route, and the tree when asked for. The step's start observation and <see cref="ObserveAsync(ExecutorObserveOptions?, CancellationToken)"/> both read it.
     /// </summary>
-    internal static ExecutorObservation View(Observation observation, AttemptScope scope, ExecutorObserveOptions? options = null) =>
-        new(SnapshotText.Render(observation, scope.Redactor, scope.AppOrigin))
+    internal ExecutorObservation View(Observation observation, AttemptScope scope, ExecutorObserveOptions? options = null)
+    {
+        var text = Text(observation, options?.Pixels == true, out var cut);
+        return new ExecutorObservation(text)
         {
-            Truncated = observation.Truncated,
+            Truncated = observation.Truncated || cut,
             KeyboardVisible = observation.KeyboardVisible,
             Path = scope.Redactor.Redact(observation.Route),
             Tree = options?.Tree == true ? AgentObservation.ProjectTree(observation.Roots, scope.Redactor, scope.AppOrigin) : null,
         };
+    }
+
+    /// <summary>
+    /// The screen as the model reads it, cut at <see cref="ByteBudget"/> (upstream's <c>prepareObservation</c> under <c>capture</c>'s
+    /// <c>maxBytes</c>). A step with a cut screen reports its observation as truncated.
+    /// </summary>
+    public string Text(Observation observation, bool pixels = false) => Text(observation, pixels, out _);
+
+    /// <inheritdoc cref="Text(Observation, bool)"/>
+    /// <param name="observation">The look to render.</param>
+    /// <param name="pixels">Whether a screenshot travels with the text.</param>
+    /// <param name="cut">Whether the byte budget cut the screen.</param>
+    public string Text(Observation observation, bool pixels, out bool cut)
+    {
+        var scope = Scope ?? throw new InvalidOperationException("This feed serves no executor.");
+        var text = SnapshotText.Render(observation, scope.Redactor, scope.AppOrigin, ByteBudget(pixels), out cut);
+        if (cut)
+        {
+            _observationTruncated = true;
+        }
+
+        return text;
+    }
+
+    /// <summary>
+    /// Bytes one act observation may contribute to a model turn, clamped like a judgment's. The loop's history grows past what any one
+    /// observation costs, so the fixed part counted here is what every turn resends: the project context, the prior-step ledger, and the
+    /// step's instruction.
+    /// </summary>
+    private int ByteBudget(bool pixels) =>
+        Options is not { } options
+            ? int.MaxValue
+            : ObservationBudget.ObservationByteBudget(
+                new ObservationBudgetLimits(options.MaxObservationBytes, options.MaxInputTokens),
+                new ObservationBudgetRequest(options.ContextBytes + options.LedgerBytes, options.InstructionBytes, pixels));
 
     /// <summary>The newest node an observation of the step listed under <paramref name="reference"/>, if any.</summary>
     public SemanticNode? LastSeen(string reference) => _seen.GetValueOrDefault(reference);
@@ -224,3 +280,11 @@ public static List<SemanticNode> FindLike(Observation observation, SemanticNode
         return name is null && testId is null ? [] : Agent.Find(observation, node.Role, name, testId, null, redactor);
     }
 }
+
+/// <summary>What the step's observations are cut under (upstream's <c>ObservationFeedOptions</c>).</summary>
+/// <param name="MaxObservationBytes">The agent's observation byte ceiling, clamped per capture by the token limit.</param>
+/// <param name="MaxInputTokens">The agent's per-request input token ceiling.</param>
+/// <param name="InstructionBytes">Bytes of the step's instruction, which opens the history every turn resends.</param>
+/// <param name="ContextBytes">Bytes of the project context every turn resends (upstream reads them from the step's metrics).</param>
+/// <param name="LedgerBytes">Bytes of the prior-step ledger every turn resends (upstream reads them from the step's metrics).</param>
+internal sealed record ObservationFeedOptions(int MaxObservationBytes, int MaxInputTokens, int InstructionBytes, int ContextBytes, int LedgerBytes);
diff --git a/src/E2E/Agent/SnapshotText.cs b/src/E2E/Agent/SnapshotText.cs
index 8727c60e..a3c71de7 100644
--- a/src/E2E/Agent/SnapshotText.cs
+++ b/src/E2E/Agent/SnapshotText.cs
@@ -13,27 +13,45 @@ internal static class SnapshotText
     /// <summary>Link target UTF-16 units a line shows; a longer target is cut there and ends with <c>…</c>.</summary>
     private const int MaxHrefLength = 256;
 
+    /// <summary>Appended when the node walk stopped at the observation byte budget (upstream's <c>TRUNCATION_MARKER</c>).</summary>
+    internal const string TruncationMarker = "[observation truncated at the resolved observation byte limit]";
+
     /// <summary>
     /// The screen as the model reads it. A link target on <paramref name="appOrigin"/>, the app base URL's, shows as its
     /// path: the one a navigation to a path resolves against.
     /// </summary>
-    public static string Render(Observation observation, Redactor redactor, string? appOrigin = null)
+    public static string Render(Observation observation, Redactor redactor, string? appOrigin = null) =>
+        Render(observation, redactor, appOrigin, int.MaxValue, out _);
+
+    /// <summary>
+    /// <see cref="Render(Observation, Redactor, string?)"/> within <paramref name="maxBytes"/>, upstream's <c>prepareObservation</c> cut: the
+    /// marker is reserved up front so a cut screen still fits, the first node is always listed, and the first node line that would
+    /// pass the budget ends the listing with <see cref="TruncationMarker"/>. <paramref name="cut"/> says whether the budget cut it.
+    /// </summary>
+    public static string Render(Observation observation, Redactor redactor, string? appOrigin, int maxBytes, out bool cut)
     {
         var builder = new StringBuilder();
         builder.Append("Screen (").Append(redactor.Redact(observation.Route)).Append("):");
-        var any = false;
+        var budget = Math.Max(0, maxBytes - Encoding.UTF8.GetByteCount(TruncationMarker + "\n"));
+        var state = new CutState(Encoding.UTF8.GetByteCount(builder.ToString() + "\n"), budget);
         foreach (var root in observation.Roots)
         {
-            any |= Write(builder, root, 0, redactor, appOrigin);
+            Write(builder, root, 0, redactor, appOrigin, state);
         }
 
-        if (!any)
+        if (!state.Any)
         {
             builder.Append('\n');
             builder.Append("(empty)");
         }
 
-        if (observation.Truncated)
+        cut = state.Cut;
+        if (state.Cut)
+        {
+            builder.Append('\n');
+            builder.Append(TruncationMarker);
+        }
+        else if (observation.Truncated)
         {
             builder.Append('\n');
             builder.Append("(More of the page is off screen. Scroll to reach it.)");
@@ -42,24 +60,45 @@ public static string Render(Observation observation, Redactor redactor, string?
         return builder.ToString();
     }
 
-    private static bool Write(StringBuilder builder, SemanticNode node, int depth, Redactor redactor, string? appOrigin)
+    // The listing's progress against its byte budget: the bytes of the lines written so far, and whether the budget stopped the walk.
+    private sealed class CutState(int bytes, int budget)
     {
-        var wrote = false;
-        if (!(node.States.Hidden || node.States.AriaHidden))
+        public bool Any { get; set; }
+
+        public bool Cut { get; set; }
+
+        public int Bytes { get; set; } = bytes;
+
+        public int Budget { get; } = budget;
+    }
+
+    private static void Write(StringBuilder builder, SemanticNode node, int depth, Redactor redactor, string? appOrigin, CutState state)
+    {
+        if (state.Cut)
         {
-            builder.Append('\n');
-            builder.Append(' ', depth * 2);
-            builder.Append("- ");
-            builder.Append(Describe(node, redactor, appOrigin, listing: true));
-            wrote = true;
+            return;
         }
 
-        foreach (var child in node.Children)
+        var hidden = node.States.Hidden || node.States.AriaHidden;
+        if (!hidden)
         {
-            wrote |= Write(builder, child, node.States.Hidden || node.States.AriaHidden ? depth : depth + 1, redactor, appOrigin);
+            var line = "\n" + new string(' ', depth * 2) + "- " + Describe(node, redactor, appOrigin, listing: true);
+            var size = Encoding.UTF8.GetByteCount(line);
+            if (state.Any && state.Bytes + size > state.Budget)
+            {
+                state.Cut = true;
+                return;
+            }
+
+            state.Bytes += size;
+            builder.Append(line);
+            state.Any = true;
         }
 
-        return wrote;
+        foreach (var child in node.Children)
+        {
+            Write(builder, child, hidden ? depth : depth + 1, redactor, appOrigin, state);
+        }
     }
 
     /// <summary>Levels of indent a <see cref="FormatNode"/> line keeps; deeper nodes line up with the tenth.</summary>
diff --git a/src/E2E/Config/E2EConfig.cs b/src/E2E/Config/E2EConfig.cs
index 5dea9c6c..1a8a3f25 100644
--- a/src/E2E/Config/E2EConfig.cs
+++ b/src/E2E/Config/E2EConfig.cs
@@ -29,6 +29,22 @@ public sealed class E2EConfig
         ["timeouts"] = "timeouts are top-level milliseconds: timeout, launchTimeout, actionTimeout, assertionTimeout, cleanupTimeout",
     };
 
+    // Upstream's REMOVED_TOP_LEVEL_KEYS: keys the runner used to accept, each mapped to what replaces it.
+    private static readonly Dictionary<string, string> RemovedTopLevelKeys = new(StringComparer.Ordinal)
+    {
+        ["specVersion"] = "delete it; the runner version is the format version",
+        ["limits"] = "set maxInputTokens on each agent (it was limits.maxModelTokensPerCall); the runner fixes maxAgentContextBytes, maxLedgerBytes, and maxEventsPerStep",
+    };
+
+    // Upstream's REMOVED_AGENT_KEYS: agent keys the runner used to accept, each mapped to what replaces it.
+    private static readonly Dictionary<string, string> RemovedAgentKeys = new(StringComparer.Ordinal)
+    {
+        ["timeout"] = "use judgmentTimeout, the deadline of one assert, waitFor, or extract call",
+        ["maxTurns"] = "use maxModelCalls, the model requests one agent call may make",
+        ["maxModelTokensPerCall"] = "use maxInputTokens",
+        ["limits"] = "set maxInputTokens on the agent; the runner fixes the other limits",
+    };
+
     private static readonly string[] TopLevelKeys =
     [
         "targets", "timeout", "launchTimeout", "actionTimeout", "assertionTimeout", "cleanupTimeout",
@@ -55,9 +71,9 @@ public sealed class E2EConfig
     private static readonly string[] Platforms = ["web", "ios", "android", "windows"];
 
     private static readonly string[] AgentKeys =
-        ["model", "judge", "provider", "system", "context", "baseUrl", "apiKeyEnv", "maxSteps", "maxModelCalls", "judgmentTimeout", "providerOptions"];
+        ["model", "judge", "provider", "system", "context", "baseUrl", "apiKeyEnv", "maxSteps", "maxModelCalls", "judgmentTimeout", "maxObservationBytes", "maxInputTokens", "providerOptions"];
 
-    private static readonly string[] UnsupportedAgentKeys = ["tools", "executor", "maxObservationBytes", "maxInputTokens"];
+    private static readonly string[] UnsupportedAgentKeys = ["tools", "executor"];
 
     private static readonly string[] CacheKeys = ["mode", "dir", "strict"];
 
@@ -212,7 +228,7 @@ private static E2EConfig Parse(string json, string projectRoot, string? configPa
                 throw Invalid("the config must be a JSON object");
             }
 
-            CheckKeys(root, "config", TopLevelKeys, UnsupportedTopLevelKeys, MovedKeys);
+            CheckKeys(root, "config", TopLevelKeys, UnsupportedTopLevelKeys, MovedKeys, RemovedTopLevelKeys);
             var ci = IsCi(environment);
             var trace = ReadRun(root, RecordingKind.Trace, environment);
             var video = ReadRun(root, RecordingKind.Video, environment);
@@ -367,7 +383,7 @@ private static ReadOnlyDictionary<string, AgentConfig> ReadAgents(JsonElement? r
                     throw Invalid(label + " must be an object");
                 }
 
-                CheckKeys(value, label, AgentKeys, UnsupportedAgentKeys, null);
+                CheckKeys(value, label, AgentKeys, UnsupportedAgentKeys, null, RemovedAgentKeys);
                 var context = AnyString(value, "context", label + ".context");
                 ResolvedAgent.CheckContext(context, label + ".context");
                 var provider = OptionalString(value, "provider", label + ".provider") ?? AgentConfig.DefaultProvider;
@@ -402,6 +418,12 @@ private static ReadOnlyDictionary<string, AgentConfig> ReadAgents(JsonElement? r
                     JudgmentTimeout = Property(value, "judgmentTimeout") is { } judgment
                         ? TimeSpan.FromMilliseconds(Integer(judgment, label + ".judgmentTimeout", 1, int.MaxValue))
                         : E2EDefaults.JudgmentTimeout,
+                    MaxObservationBytes = Property(value, "maxObservationBytes") is { } bytes
+                        ? Integer(bytes, label + ".maxObservationBytes", ResolvedAgent.MinObservationBytes, ResolvedAgent.MaxObservationBytesLimit)
+                        : E2EDefaults.MaxObservationBytes,
+                    MaxInputTokens = Property(value, "maxInputTokens") is { } tokens
+                        ? Integer(tokens, label + ".maxInputTokens", 1, ResolvedAgent.MaxInputTokensLimit)
+                        : E2EDefaults.MaxInputTokens,
                     ProviderOptions = ReadProviderOptions(Property(value, "providerOptions"), label),
                 };
             }
@@ -572,11 +594,16 @@ private static Secrets ReadSecrets(JsonElement? raw, Func<string, string?> envir
         return new Secrets(values);
     }
 
-    private static void CheckKeys(JsonElement value, string label, string[] allowed, string[] unsupported, Dictionary<string, string>? moved)
+    private static void CheckKeys(JsonElement value, string label, string[] allowed, string[] unsupported, Dictionary<string, string>? moved, Dictionary<string, string>? removed = null)
     {
         foreach (var property in value.EnumerateObject())
         {
             var key = property.Name;
+            if (removed is not null && removed.TryGetValue(key, out var replacement))
+            {
+                throw Invalid((label == "config" ? key : label + "." + key) + " was removed: " + replacement);
+            }
+
             if (allowed.Contains(key, StringComparer.Ordinal))
             {
                 continue;
@@ -650,7 +677,7 @@ private static int Integer(JsonElement value, string label, int min, int max)
         {
             throw Invalid(max == int.MaxValue
                 ? label + " must be a positive integer"
-                : label + " must be an integer from " + min.ToString(CultureInfo.InvariantCulture) + " to " + max.ToString(CultureInfo.InvariantCulture));
+                : label + " must be an integer from " + min.ToString(CultureInfo.InvariantCulture) + " through " + max.ToString(CultureInfo.InvariantCulture));
         }
 
         return number;
@@ -781,6 +808,12 @@ public sealed class AgentConfig
 
     public TimeSpan JudgmentTimeout { get; init; } = E2EDefaults.JudgmentTimeout;
 
+    /// <summary>1024 through 16777216. See <see cref="AgentOptions.MaxObservationBytes"/>.</summary>
+    public int MaxObservationBytes { get; init; } = E2EDefaults.MaxObservationBytes;
+
+    /// <summary>1 through 1000000. See <see cref="AgentOptions.MaxInputTokens"/>.</summary>
+    public int MaxInputTokens { get; init; } = E2EDefaults.MaxInputTokens;
+
     /// <summary>Provider options by provider. Each client adds the entry under its own key to its request body.</summary>
     public IReadOnlyDictionary<string, JsonElement>? ProviderOptions { get; init; }
 
@@ -802,6 +835,8 @@ public AgentOptions CreateOptions()
             MaxSteps = MaxSteps,
             MaxModelCalls = MaxModelCalls,
             JudgmentTimeout = JudgmentTimeout,
+            MaxObservationBytes = MaxObservationBytes,
+            MaxInputTokens = MaxInputTokens,
             ProviderOptions = ProviderOptions,
         };
     }
diff --git a/src/E2E/Config/E2EDefaults.cs b/src/E2E/Config/E2EDefaults.cs
index c2a83948..00293bf6 100644
--- a/src/E2E/Config/E2EDefaults.cs
+++ b/src/E2E/Config/E2EDefaults.cs
@@ -42,4 +42,13 @@ public static class E2EDefaults
 
     /// <summary>Upstream <c>maxSteps</c>: actions one <c>act</c> may take.</summary>
     public const int MaxSteps = 25;
+
+    /// <summary>
+    /// Upstream's <c>DEFAULT_OBSERVATION_BYTES</c>, the default of <c>maxObservationBytes</c>. A quarter mebibyte of tree is already tens of
+    /// thousands of tokens on every act turn; the per-call token ceiling clamps a dense screen below it.
+    /// </summary>
+    public const int MaxObservationBytes = 262_144;
+
+    /// <summary>Upstream's <c>DEFAULT_INPUT_TOKENS</c>, the default of <c>maxInputTokens</c>: the input one model request may carry.</summary>
+    public const int MaxInputTokens = 64_000;
 }
diff --git a/src/E2E/Explore/Executor.cs b/src/E2E/Explore/Executor.cs
index e3817dc4..654e63da 100644
--- a/src/E2E/Explore/Executor.cs
+++ b/src/E2E/Explore/Executor.cs
@@ -77,6 +77,8 @@ internal static AgentOptions ExplorerAgent(ExplorerOptions options)
             MaxSteps = entry.MaxSteps,
             MaxModelCalls = entry.MaxModelCalls,
             JudgmentTimeout = entry.JudgmentTimeout,
+            MaxObservationBytes = entry.MaxObservationBytes,
+            MaxInputTokens = entry.MaxInputTokens,
             ProviderOptions = entry.ProviderOptions,
             Tools = entry.Tools,
         };
@@ -99,6 +101,8 @@ internal static AgentOptions WithFindingTool(AgentOptions explorer, ExploreState
             MaxSteps = explorer.MaxSteps,
             MaxModelCalls = explorer.MaxModelCalls,
             JudgmentTimeout = explorer.JudgmentTimeout,
+            MaxObservationBytes = explorer.MaxObservationBytes,
+            MaxInputTokens = explorer.MaxInputTokens,
             ProviderOptions = explorer.ProviderOptions,
             Tools = tools,
         };
diff --git a/src/E2E/Explore/Explore.cs b/src/E2E/Explore/Explore.cs
index cdeab240..9007658e 100644
--- a/src/E2E/Explore/Explore.cs
+++ b/src/E2E/Explore/Explore.cs
@@ -237,6 +237,8 @@ public static async Task<ExploreOutcome> ExploreAsync(ExploreOptions options, Ca
             MaxSteps = defaultAgent.MaxSteps ?? E2EDefaults.MaxSteps,
             MaxModelCalls = defaultAgent.MaxModelCalls ?? E2EDefaults.MaxModelCalls,
             JudgmentTimeout = defaultAgent.JudgmentTimeout,
+            MaxObservationBytes = defaultAgent.MaxObservationBytes,
+            MaxInputTokens = defaultAgent.MaxInputTokens,
             ProviderOptions = defaultAgent.ProviderOptions,
             Agents = entries.Where(pair => !string.Equals(pair.Key, "default", StringComparison.Ordinal)).ToDictionary(pair => pair.Key, pair => pair.Value, StringComparer.Ordinal),
             BaseUrl = target.App.Url,
@@ -433,6 +435,8 @@ private static TargetConfig PickTarget(IReadOnlyList<TargetConfig> targets, stri
         MaxSteps = explorer.MaxSteps ?? DefaultStepBudget,
         MaxModelCalls = explorer.MaxModelCalls ?? DefaultStepBudget,
         JudgmentTimeout = explorer.JudgmentTimeout,
+        MaxObservationBytes = explorer.MaxObservationBytes,
+        MaxInputTokens = explorer.MaxInputTokens,
         ProviderOptions = explorer.ProviderOptions,
         Tools = explorer.Tools,
     };
diff --git a/src/E2E/Locator/Screen.cs b/src/E2E/Locator/Screen.cs
index 603e0e1d..cd1060ec 100644
--- a/src/E2E/Locator/Screen.cs
+++ b/src/E2E/Locator/Screen.cs
@@ -278,7 +278,7 @@ async Task<string> Read()
                 var read = ObserveAsync(bounded.Token);
                 _ = read.ContinueWith(static finished => _ = finished.Exception, CancellationToken.None, TaskContinuationOptions.OnlyOnFaulted | TaskContinuationOptions.ExecuteSynchronously, TaskScheduler.Default);
                 var observation = await read.WaitAsync(bounded.Token).ConfigureAwait(false);
-                return RenderTree?.Invoke(observation) ?? Redact(TreeText(observation, Redactor.None, null, StepScreens.DefaultObservationBytes));
+                return RenderTree?.Invoke(observation) ?? Redact(TreeText(observation, Redactor.None, null, E2EDefaults.MaxObservationBytes));
             }
             catch (OperationCanceledException) when (bounded.IsCancellationRequested && !token.IsCancellationRequested)
             {
diff --git a/src/E2E/Report/BuildReport.cs b/src/E2E/Report/BuildReport.cs
index 44dd1463..b25dc38c 100644
--- a/src/E2E/Report/BuildReport.cs
+++ b/src/E2E/Report/BuildReport.cs
@@ -52,6 +52,9 @@ internal sealed record BuildReportOptions
 
     public bool Ci { get; init; }
 
+    /// <summary>The run's resolved limits (upstream's <c>config.limits</c>); the defaults when null (upstream's <c>DEFAULT_LIMITS</c>).</summary>
+    public ReportLimits? Limits { get; init; }
+
     /// <summary>When the run finished; the time of the build when null (upstream's <c>timestamp()</c>).</summary>
     public DateTimeOffset? FinishedAt { get; init; }
 }
@@ -315,7 +318,7 @@ public static Report1Document Build(BuildReportOptions options)
             Vcs = options.Vcs,
             Errors = options.RunErrors,
             Summary = summary,
-            Limits = ReportLimits.Default,
+            Limits = options.Limits ?? ReportLimits.Default,
             Usage = ComputeUsage(options.Results, summary.Discovered),
             Changes = options.Changes,
             Filters = options.Filters,
diff --git a/src/E2E/Report/ReportFile.cs b/src/E2E/Report/ReportFile.cs
index a5fd5252..f98f8ca6 100644
--- a/src/E2E/Report/ReportFile.cs
+++ b/src/E2E/Report/ReportFile.cs
@@ -52,6 +52,9 @@ private sealed class RunState(string runId, DateTimeOffset startedAt, Task<VcsIn
         public List<ReportTarget> Targets { get; } = [];
 
         public ReportExplore? Explore { get; set; }
+
+        /// <summary>The run's limits: the largest any test's agents allowed.</summary>
+        public ReportLimits? Limits { get; set; }
     }
 
     /// <summary>Where the document of the run whose results go to <paramref name="resultsRoot"/> is written.</summary>
@@ -131,6 +134,7 @@ public static async Task<JsonObject> SingleAsync(Report1Document report, string?
             Results = [result],
             ReportTargets = report.Run.Targets,
             Explore = report.Run.Explore,
+            Limits = report.Run.Limits,
             Vcs = await VcsOf(DetectVcs(projectRoot)).ConfigureAwait(false),
             Ci = E2EConfig.IsCi(),
         });
@@ -175,6 +179,7 @@ public static async Task WriteAsync(Report1Document report, string projectRoot,
             }
 
             state.Explore = report.Run.Explore ?? state.Explore;
+            state.Limits = report.Run.Limits is { } limits ? state.Limits?.Max(limits) ?? limits : state.Limits;
             var (status, exitCode) = StatusOf(state.Results.Values.Select(entry => entry.Result));
             var document = BuildReport.Build(new BuildReportOptions
             {
@@ -186,6 +191,7 @@ public static async Task WriteAsync(Report1Document report, string projectRoot,
                 ExitCode = exitCode,
                 Results = [.. state.Results.Values.Select(entry => entry.Result)],
                 Explore = state.Explore,
+                Limits = state.Limits,
                 Vcs = await VcsOf(state.Vcs).ConfigureAwait(false),
                 Ci = E2EConfig.IsCi(),
             });
diff --git a/src/E2E/Report/ReportRecords.cs b/src/E2E/Report/ReportRecords.cs
index da2027c6..73c40ff2 100644
--- a/src/E2E/Report/ReportRecords.cs
+++ b/src/E2E/Report/ReportRecords.cs
@@ -300,10 +300,20 @@ internal sealed record ReportSummary(int Discovered, int Selected, int Executed,
 internal sealed record ReportLimits(int MaxAgentContextBytes, int MaxLedgerBytes, int MaxObservationBytes, int MaxEventsPerStep, int MaxModelTokensPerCall)
 {
     /// <summary>
-    /// Upstream's <c>DEFAULT_LIMITS</c>. The port has no per-agent <c>maxObservationBytes</c> or <c>maxInputTokens</c> (the config rejects
-    /// them), so every run reports the defaults, as upstream does for a run that failed before its config resolved.
+    /// Upstream's <c>DEFAULT_LIMITS</c>: the limits of a run no agent config has shaped, which is also what a run that failed before its
+    /// config resolved reports.
     /// </summary>
-    public static ReportLimits Default { get; } = new(ResolvedAgent.MaxContextBytes, Ledger.MaxLedgerBytes, StepScreens.DefaultObservationBytes, 1_000, 64_000);
+    public static ReportLimits Default { get; } = new(ResolvedAgent.MaxContextBytes, Ledger.MaxLedgerBytes, E2EDefaults.MaxObservationBytes, 1_000, E2EDefaults.MaxInputTokens);
+
+    /// <summary>
+    /// The limits of two runs merged: the per-agent ones at the largest either allowed, so the report does not read lower than what a step
+    /// could send. The port builds one report per test and merges them into the run's.
+    /// </summary>
+    public ReportLimits Max(ReportLimits other) => this with
+    {
+        MaxObservationBytes = Math.Max(MaxObservationBytes, other.MaxObservationBytes),
+        MaxModelTokensPerCall = Math.Max(MaxModelTokensPerCall, other.MaxModelTokensPerCall),
+    };
 }
 
 /// <summary>What the run used, against <see cref="ReportLimits"/> (upstream's <c>ReportUsage</c>).</summary>
diff --git a/src/E2E/Run/AttemptReport.cs b/src/E2E/Run/AttemptReport.cs
index 827abe5e..0b18c359 100644
--- a/src/E2E/Run/AttemptReport.cs
+++ b/src/E2E/Run/AttemptReport.cs
@@ -142,7 +142,7 @@ .. videos.Select((video, index) => Artifact(video, index, directory, attemptSegm
             Attempts = [attempt],
             Directory = directory,
         };
-        return (new Report1Document(new ReportRun(RunId, ModelHttp.PackageVersion(), [new ReportTarget(scope.TargetName, 0, scope.EnginePlatform, BuildReport.DescribeTarget(scope.EnginePlatform, scope.EngineVersion, scope.EngineCapabilities), "test", BuildReport.BaseOrigin(scope.BaseUrl))], [result], explore)), id);
+        return (new Report1Document(new ReportRun(RunId, ModelHttp.PackageVersion(), [new ReportTarget(scope.TargetName, 0, scope.EnginePlatform, BuildReport.DescribeTarget(scope.EnginePlatform, scope.EngineVersion, scope.EngineCapabilities), "test", BuildReport.BaseOrigin(scope.BaseUrl))], [result], explore) { Limits = ResolvedAgent.RunLimits(scope.Agents.Values) }), id);
     }
 
     // The size of a file the attempt kept, which the run's usage adds up; null for a link and for a file that cannot be read.
diff --git a/src/E2E/Run/E2EFixture.cs b/src/E2E/Run/E2EFixture.cs
index 8823c9e9..0b7b202d 100644
--- a/src/E2E/Run/E2EFixture.cs
+++ b/src/E2E/Run/E2EFixture.cs
@@ -82,6 +82,12 @@ protected virtual IReadOnlyDictionary<string, AgentOptions> CreateAgents()
     /// <summary><c>agents.default.judgmentTimeout</c>.</summary>
     protected virtual TimeSpan JudgmentTimeout => Config.Agent.JudgmentTimeout;
 
+    /// <summary><c>agents.default.maxObservationBytes</c>.</summary>
+    protected virtual int MaxObservationBytes => Config.Agent.MaxObservationBytes;
+
+    /// <summary><c>agents.default.maxInputTokens</c>.</summary>
+    protected virtual int MaxInputTokens => Config.Agent.MaxInputTokens;
+
     /// <summary><c>agents.default.providerOptions</c>.</summary>
     protected virtual IReadOnlyDictionary<string, System.Text.Json.JsonElement>? ProviderOptions => Config.Agent.ProviderOptions;
 
@@ -200,6 +206,8 @@ protected async Task StartSessionAsync(string title, int attempt, Action<TestExc
                 AgentTools = AgentTools,
                 AgentContext = AgentContext,
                 JudgmentTimeout = JudgmentTimeout,
+                MaxObservationBytes = MaxObservationBytes,
+                MaxInputTokens = MaxInputTokens,
                 ProviderOptions = ProviderOptions,
                 Agents = CreateAgents(),
                 Agent = TestAgentOptions.Agent(GetType(), testMethod) ?? RunAgent,
diff --git a/src/E2E/Run/E2ESession.cs b/src/E2E/Run/E2ESession.cs
index f33d0f96..2a2d2dba 100644
--- a/src/E2E/Run/E2ESession.cs
+++ b/src/E2E/Run/E2ESession.cs
@@ -133,6 +133,7 @@ internal static async Task<E2ESession> LaunchAsync(E2ESessionOptions options, IR
         ArgumentNullException.ThrowIfNull(options.Engine);
         ArgumentException.ThrowIfNullOrWhiteSpace(options.TestTitle);
         var agents = ResolveAgents(options);
+        var runLimits = ResolvedAgent.RunLimits(agents.Values);
         if (options.Agent is { } pinned && !agents.ContainsKey(pinned))
         {
             throw new TestException("INVALID_ARGUMENT", "unknown agent \"" + pinned + "\"; configured: " + string.Join(", ", agents.Keys));
@@ -259,7 +260,7 @@ internal static async Task<E2ESession> LaunchAsync(E2ESessionOptions options, IR
             }
 
             // A screen is read once, when its step ends, redacted with what the attempt knows by then.
-            screens.Route(screen => scope.Steps.RecordScreen(() => StepScreens.TraceScreen(screen, new TraceScreenOptions(scope.Redactor, StepScreens.DefaultObservationBytes, scope.AppOrigin))));
+            screens.Route(screen => scope.Steps.RecordScreen(() => StepScreens.TraceScreen(screen, new TraceScreenOptions(scope.Redactor, runLimits.MaxObservationBytes, scope.AppOrigin))));
 
             // What the app did on its own while the engine launched waits here, and goes under the step it happened in.
             appLog.Route((appEvent, at) => scope.Steps.RecordAppEvent(appEvent, at));
@@ -287,7 +288,7 @@ internal static async Task<E2ESession> LaunchAsync(E2ESessionOptions options, IR
             screen.RememberSecret = secret => scope.Remember(new Dictionary<string, object?>(StringComparer.Ordinal) { [secret.Name] = secret });
             screen.Redact = text => scope.Redactor.Redact(text);
             screen.Failed = scope.Implicate;
-            screen.RenderTree = observation => Screen.TreeText(observation, scope.Redactor, scope.AppOrigin, StepScreens.DefaultObservationBytes);
+            screen.RenderTree = observation => Screen.TreeText(observation, scope.Redactor, scope.AppOrigin, runLimits.MaxObservationBytes);
             screen.Screenshots = scope.Screenshots = new ScreenshotContext
             {
                 ProjectRoot = projectRoot,
@@ -500,6 +501,8 @@ private static Dictionary<string, ResolvedAgent> ResolveAgents(E2ESessionOptions
                 MaxSteps = options.MaxSteps,
                 MaxModelCalls = options.MaxModelCalls,
                 JudgmentTimeout = options.JudgmentTimeout,
+                MaxObservationBytes = options.MaxObservationBytes,
+                MaxInputTokens = options.MaxInputTokens,
                 ProviderOptions = options.ProviderOptions,
                 Tools = options.AgentTools,
             }),
@@ -602,6 +605,7 @@ public async Task CaptureFailureEvidenceAsync(Exception error)
                 Error = error,
                 Redactor = _scope.Redactor,
                 AppOrigin = _scope.AppOrigin,
+                MaxObservationBytes = ResolvedAgent.RunLimits(_scope.Agents.Values).MaxObservationBytes,
                 AttemptDir = trace.AttemptDir,
             }).ConfigureAwait(false);
         }
@@ -828,6 +832,12 @@ public sealed class E2ESessionOptions
     /// <summary>The default agent's <c>judgmentTimeout</c>: the deadline of one <c>assert</c>, <c>waitFor</c>, or <c>extract</c>.</summary>
     public TimeSpan JudgmentTimeout { get; init; } = E2EDefaults.JudgmentTimeout;
 
+    /// <summary>The default agent's <c>maxObservationBytes</c>. See <see cref="AgentOptions.MaxObservationBytes"/>.</summary>
+    public int MaxObservationBytes { get; init; } = E2EDefaults.MaxObservationBytes;
+
+    /// <summary>The default agent's <c>maxInputTokens</c>. See <see cref="AgentOptions.MaxInputTokens"/>.</summary>
+    public int MaxInputTokens { get; init; } = E2EDefaults.MaxInputTokens;
+
     /// <summary>The default agent's provider options, keyed by provider. See <see cref="ModelRequest.ProviderOptions"/>.</summary>
     public IReadOnlyDictionary<string, JsonElement>? ProviderOptions { get; init; }
 
diff --git a/src/E2E/Run/FailureEvidence.cs b/src/E2E/Run/FailureEvidence.cs
index 6d611d5b..b2e8f2ff 100644
--- a/src/E2E/Run/FailureEvidence.cs
+++ b/src/E2E/Run/FailureEvidence.cs
@@ -32,7 +32,7 @@ internal sealed record FailureEvidenceOptions
     public required string AttemptDir { get; init; }
 
     /// <summary>Bytes of text the screen lists before it is cut.</summary>
-    public int MaxObservationBytes { get; init; } = StepScreens.DefaultObservationBytes;
+    public int MaxObservationBytes { get; init; } = E2EDefaults.MaxObservationBytes;
 }
 
 /// <summary>
diff --git a/src/E2E/Run/StepScreens.cs b/src/E2E/Run/StepScreens.cs
index 5d3f051d..e814ddec 100644
--- a/src/E2E/Run/StepScreens.cs
+++ b/src/E2E/Run/StepScreens.cs
@@ -51,9 +51,6 @@ internal static class StepScreens
     /// <summary>Characters of one change line.</summary>
     private const int MaxChangeChars = 200;
 
-    /// <summary>The observation byte budget upstream's <c>agent.maxObservationBytes</c> defaults to. The port has no such key.</summary>
-    internal const int DefaultObservationBytes = 262_144;
-
     /// <summary>The step's screen against the one <c>since</c> saw, or as the first screen when there was none.</summary>
     public static StepScreen CompareScreens((int Step, ScreenText Screen)? previous, ScreenText next)
     {
diff --git a/tests/E2E.Tests/AgentConfig/ACustomExecutorTests.cs b/tests/E2E.Tests/AgentConfig/ACustomExecutorTests.cs
index fa81da4f..247a9fb9 100644
--- a/tests/E2E.Tests/AgentConfig/ACustomExecutorTests.cs
+++ b/tests/E2E.Tests/AgentConfig/ACustomExecutorTests.cs
@@ -46,12 +46,14 @@ public void Accepts_the_model_judge_context_and_budgets_alongside_it()
             Context = "Plans are tiers.",
             MaxModelCalls = 40,
             JudgmentTimeout = TimeSpan.FromSeconds(60),
+            MaxInputTokens = 8_000,
         });
 
         Assert.Equal("custom-brain", agent.Executor!.Name);
         Assert.Equal("Plans are tiers.", agent.Context);
         Assert.Equal(40, agent.MaxModelCalls);
         Assert.Equal(TimeSpan.FromSeconds(60), agent.JudgmentTimeout);
+        Assert.Equal(8_000, agent.MaxInputTokens);
         Assert.Same(model, agent.Model);
         Assert.Same(judge, agent.Judge);
     }
diff --git a/tests/E2E.Tests/AgentConfig/AgentConfigDefaultsTests.cs b/tests/E2E.Tests/AgentConfig/AgentConfigDefaultsTests.cs
index c411f033..44b1be52 100644
--- a/tests/E2E.Tests/AgentConfig/AgentConfigDefaultsTests.cs
+++ b/tests/E2E.Tests/AgentConfig/AgentConfigDefaultsTests.cs
@@ -4,8 +4,6 @@
 
 namespace E2E.Tests.AgentConfig;
 
-// Upstream's maxObservationBytes and maxInputTokens bounds have no port: the keys are rejected (see COMPATIBILITY.md, Agents).
-// Its removed-key hint for agents.<name>.timeout has no port either: an unknown key is rejected as one.
 public sealed class AgentConfigDefaultsTests
 {
     private static readonly string Root = Path.Combine(Path.GetTempPath(), "e2e-agent-config-project");
@@ -33,11 +31,18 @@ public void Rejects_agent_providerOptions_that_is_not_a_record_of_provider_recor
     }
 
     [Fact]
-    public void Bounds_maxSteps_and_maxModelCalls_to_1_through_100()
+    public void Bounds_budgets_to_1_through_100_observation_bytes_to_1_KiB_through_16_MiB_and_input_tokens_to_1_through_1000000()
     {
         Assert.Contains("maxSteps", Invalid("""{ "agents": { "default": { "maxSteps": 0 } } }"""), StringComparison.Ordinal);
         Assert.Contains("maxSteps", Invalid("""{ "agents": { "default": { "maxSteps": 101 } } }"""), StringComparison.Ordinal);
         Assert.Contains("maxModelCalls", Invalid("""{ "agents": { "default": { "maxModelCalls": 101 } } }"""), StringComparison.Ordinal);
+        Assert.Contains("maxObservationBytes", Invalid("""{ "agents": { "default": { "maxObservationBytes": 1023 } } }"""), StringComparison.Ordinal);
+        Assert.Contains("maxObservationBytes", Invalid("""{ "agents": { "default": { "maxObservationBytes": 16777217 } } }"""), StringComparison.Ordinal);
+        Assert.Equal(200_000, Parse("""{ "agents": { "default": { "maxInputTokens": 200000 } } }""").Agent.MaxInputTokens);
+        Assert.Equal(
+            "agents.default.maxInputTokens must be an integer from 1 through 1000000",
+            Invalid("""{ "agents": { "default": { "maxInputTokens": 0 } } }"""));
+        Assert.Contains("agents.default.maxInputTokens", Invalid("""{ "agents": { "default": { "maxInputTokens": 1000001 } } }"""), StringComparison.Ordinal);
     }
 
     [Fact]
@@ -60,6 +65,15 @@ public void Rejects_unknown_agent_keys_with_the_nearest_one_including_the_remove
         Assert.Equal(
             "unknown agents.default key \"sytem\"; did you mean \"system\"?",
             Invalid("""{ "agents": { "default": { "sytem": "Be careful." } } }"""));
+        Assert.Equal(
+            "unknown agents.ux key \"maxInputToken\"; did you mean \"maxInputTokens\"?",
+            Invalid("""{ "agents": { "ux": { "maxInputToken": 1000 } } }"""));
+    }
+
+    [Fact]
+    public void Rejects_a_removed_agent_key_naming_its_replacement()
+    {
+        Assert.Contains("agents.default.timeout was removed: use judgmentTimeout", Invalid("""{ "agents": { "default": { "timeout": 30000 } } }"""), StringComparison.Ordinal);
     }
 
     [Fact]
diff --git a/tests/E2E.Tests/AgentConfig/RunLimitsTests.cs b/tests/E2E.Tests/AgentConfig/RunLimitsTests.cs
new file mode 100644
index 00000000..7a108f23
--- /dev/null
+++ b/tests/E2E.Tests/AgentConfig/RunLimitsTests.cs
@@ -0,0 +1,49 @@
+// Copyright 2026 TesterArmy.
+// Modified by Dario Kondratiuk.
+// SPDX-License-Identifier: Apache-2.0
+
+namespace E2E.Tests.AgentConfig;
+
+/// <summary>Upstream's <c>describe('run limits')</c> (<c>tests/unit/agent-config.test.ts</c>).</summary>
+public sealed class RunLimitsTests
+{
+    private static readonly string Root = Path.Combine(Path.GetTempPath(), "e2e-agent-config-project");
+
+    /// <summary>Partial: upstream resolves the config twice, once with <c>cli: { agents: ['ux'] }</c>, to show the limits do not depend on the agent that runs. The port has no agent selection on a run, so it resolves once.</summary>
+    [Fact]
+    public void Partial_fills_the_per_agent_limits_with_the_largest_any_configured_agent_may_use_whichever_runs()
+    {
+        var config = Parse(
+            """
+            { "agents": { "default": { "maxObservationBytes": 4096, "maxInputTokens": 200000 }, "ux": { "maxObservationBytes": 65536, "maxInputTokens": 8000 } } }
+            """);
+
+        var limits = Limits(config);
+
+        Assert.Equal(65_536, limits.MaxObservationBytes);
+        Assert.Equal(200_000, limits.MaxModelTokensPerCall);
+        Assert.Equal(8_192, limits.MaxLedgerBytes);
+        // The implicit default agent counts too.
+        Assert.Equal(64_000, Limits(Parse("""{ "agents": { "ux": { "maxInputTokens": 8000 } } }""")).MaxModelTokensPerCall);
+    }
+
+    [Fact]
+    public void Rejects_the_removed_limits_key_naming_each_replacement()
+    {
+        Assert.StartsWith("limits was removed: set maxInputTokens on each agent", Invalid("""{ "limits": { "maxModelTokensPerCall": 1000 } }"""), StringComparison.Ordinal);
+        Assert.StartsWith("limits was removed: ", Invalid("""{ "limits": {} }"""), StringComparison.Ordinal);
+        Assert.StartsWith("agents.default.limits was removed: set maxInputTokens", Invalid("""{ "agents": { "default": { "limits": {} } } }"""), StringComparison.Ordinal);
+    }
+
+    private static ReportLimits Limits(E2EConfig config) =>
+        ResolvedAgent.RunLimits(config.Agents.Select(pair => ResolvedAgent.From(pair.Key, pair.Value.CreateOptions())));
+
+    private static E2EConfig Parse(string json) => E2EConfig.Parse(json, Root, _ => null);
+
+    private static string Invalid(string json)
+    {
+        var error = Assert.Throws<ConfigurationException>(() => Parse(json));
+        Assert.Equal("INVALID_CONFIG", error.Code);
+        return error.Message;
+    }
+}
diff --git a/tests/E2E.Tests/AgentConfig/TheAgentsEntryShapeTests.cs b/tests/E2E.Tests/AgentConfig/TheAgentsEntryShapeTests.cs
index 4172d777..b1a6e937 100644
--- a/tests/E2E.Tests/AgentConfig/TheAgentsEntryShapeTests.cs
+++ b/tests/E2E.Tests/AgentConfig/TheAgentsEntryShapeTests.cs
@@ -27,7 +27,7 @@ public void Gives_every_agent_the_built_in_defaults_never_another_agents_values(
     {
         var config = E2EConfig.Parse(
             """
-            { "agents": { "default": { "model": "gpt-4.1-mini", "judge": "o4-mini", "system": "Be careful.", "context": "Plans are tiers.", "maxSteps": 5, "judgmentTimeout": 90000 }, "ux": {} } }
+            { "agents": { "default": { "model": "gpt-4.1-mini", "judge": "o4-mini", "system": "Be careful.", "context": "Plans are tiers.", "maxSteps": 5, "judgmentTimeout": 90000, "maxInputTokens": 10000 }, "ux": {} } }
             """,
             Root,
             _ => null);
@@ -39,6 +39,7 @@ public void Gives_every_agent_the_built_in_defaults_never_another_agents_values(
         Assert.Null(ux.Context);
         Assert.Null(ux.MaxSteps);
         Assert.Equal(E2EDefaults.JudgmentTimeout, ux.JudgmentTimeout);
+        Assert.Equal(64_000, ux.MaxInputTokens);
         Assert.Equal(5, config.Agent.MaxSteps);
     }
 }
diff --git a/tests/E2E.Tests/AgentObservation/ObservationByteBudgetTests.cs b/tests/E2E.Tests/AgentObservation/ObservationByteBudgetTests.cs
new file mode 100644
index 00000000..b541b08f
--- /dev/null
+++ b/tests/E2E.Tests/AgentObservation/ObservationByteBudgetTests.cs
@@ -0,0 +1,29 @@
+// Copyright 2026 TesterArmy.
+// Modified by Dario Kondratiuk.
+// SPDX-License-Identifier: Apache-2.0
+
+using E2E.Engine;
+using E2E.Internal;
+
+namespace E2E.Tests.AgentObservation;
+
+/// <summary>Upstream's <c>describe('observation byte budget')</c> (<c>tests/unit/agent-observation.test.ts</c>).</summary>
+public sealed class ObservationByteBudgetTests
+{
+    /// <summary>Partial: upstream reads <c>prepared.bytes</c> and <c>prepared.truncated</c> of <c>prepareObservation</c>. The port reads the byte size of the rendered text and the cut flag of <c>Render</c>.</summary>
+    [Fact]
+    public void Partial_never_exceeds_the_budget_including_the_truncation_marker()
+    {
+        // The budget is what keeps a request under the per-call token ceiling, so overshooting it by the marker length can tip a large page over.
+        var children = Enumerable.Range(0, 400).Select(index => new SemanticNode { Ref = "c" + index, Role = "button", Name = "Button number " + index }).ToList();
+        var tree = new SemanticNode { Ref = "n1", Role = "document", Children = children };
+        foreach (var maxBytes in new[] { 200, 512, 2_048, 4_096 })
+        {
+            var text = SnapshotText.Render(new Observation { Route = "/", Roots = [tree] }, Redactor.None, null, maxBytes, out var cut);
+
+            Assert.True(System.Text.Encoding.UTF8.GetByteCount(text) <= maxBytes, "within " + maxBytes);
+            Assert.True(cut);
+            Assert.Contains("[observation truncated", text, StringComparison.Ordinal);
+        }
+    }
+}
diff --git a/tests/E2E.Tests/AgentObservation/PrepareObservationTests.cs b/tests/E2E.Tests/AgentObservation/PrepareObservationTests.cs
index 99862603..e28dc759 100644
--- a/tests/E2E.Tests/AgentObservation/PrepareObservationTests.cs
+++ b/tests/E2E.Tests/AgentObservation/PrepareObservationTests.cs
@@ -9,13 +9,12 @@ namespace E2E.Tests.AgentObservation;
 
 /// <summary>
 /// The port renders the screen as one text block in its own format, with no pixel evidence, executor tree, node
-/// index, byte budget, or cut fields. So these upstream its are not ported: "keeps unavailable semantics separate from
+/// index, or cut fields. So these upstream its are not ported: "keeps unavailable semantics separate from
 /// an empty tree and requires permitted masked evidence", "returns evidence without a comparable shape without
 /// repeating capture", "redacts the leading
 /// part of a secret a field cut at its limit ends with, and leaves a cut plain value and a whole field alone", "redacts
 /// every string field a node carries, in the text, the executor tree, and the node index alike", "redacts an earlier
-/// capture again with a secret resolved since, keeping which nodes are leaves", "truncates at the byte limit while
-/// keeping the root and flagging truncation", and "reports the byte cut, not the engine cut, when both apply". The last three
+/// capture again with a secret resolved since, keeping which nodes are leaves". The last three
 /// tests below are .NET-only: upstream proves a granted, tainted, or uncounted capture through its runner.
 /// </summary>
 public sealed class PrepareObservationTests
@@ -30,6 +29,31 @@ public void Marks_an_engine_reported_cut_as_truncated_with_the_ports_marker()
         Assert.EndsWith("\n(More of the page is off screen. Scroll to reach it.)", text, StringComparison.Ordinal);
     }
 
+    /// <summary>Partial: upstream "truncates at the byte limit while keeping the root and flagging truncation" reads the flag, the node index (201 nodes), and the text from <c>prepareObservation</c>. The port has no node index: it checks the text and the cut flag of <c>Render</c>.</summary>
+    [Fact]
+    public void Partial_truncates_at_the_byte_limit_while_keeping_the_root_and_flagging_truncation()
+    {
+        var children = Enumerable.Range(0, 200).Select(index => new SemanticNode { Ref = "c" + index, Role = "button", Name = "Button number " + index }).ToList();
+        var tree = new SemanticNode { Ref = "n1", Role = "document", Children = children };
+        var text = SnapshotText.Render(new Observation { Route = "/", Roots = [tree] }, Redactor.None, null, 256, out var cut);
+        Assert.True(cut);
+        Assert.StartsWith("Screen (/):\n- document [ref=n1]", text, StringComparison.Ordinal);
+        Assert.Contains("[observation truncated", text, StringComparison.Ordinal);
+    }
+
+    /// <summary>Partial: upstream "reports the byte cut, not the engine cut, when both apply" reads <c>prepared.bytes</c> and the engine marker's words. The port's engine marker is its own, and it counts the text's bytes itself.</summary>
+    [Fact]
+    public void Partial_reports_the_byte_cut_not_the_engine_cut_when_both_apply()
+    {
+        var children = Enumerable.Range(0, 200).Select(index => new SemanticNode { Ref = "c" + index, Role = "button", Name = "Button " + index }).ToList();
+        var tree = new SemanticNode { Ref = "n1", Role = "document", Children = children };
+        var text = SnapshotText.Render(new Observation { Route = "/", Roots = [tree], Truncated = true }, Redactor.None, null, 256, out var cut);
+        Assert.True(cut);
+        Assert.True(System.Text.Encoding.UTF8.GetByteCount(text) <= 256);
+        Assert.EndsWith("[observation truncated at the resolved observation byte limit]", text, StringComparison.Ordinal);
+        Assert.DoesNotContain("off screen", text, StringComparison.Ordinal);
+    }
+
     [Fact]
     public void Withholds_pixels_whose_masking_the_engine_cannot_prove_and_keeps_the_tree()
     {
diff --git a/tests/E2E.Tests/AgentObservationBudget/ObservationBudgetWiringTests.cs b/tests/E2E.Tests/AgentObservationBudget/ObservationBudgetWiringTests.cs
new file mode 100644
index 00000000..96fa5aa2
--- /dev/null
+++ b/tests/E2E.Tests/AgentObservationBudget/ObservationBudgetWiringTests.cs
@@ -0,0 +1,87 @@
+// Copyright 2026 TesterArmy.
+// Modified by Dario Kondratiuk.
+// SPDX-License-Identifier: Apache-2.0
+
+using System.Globalization;
+using E2E.Engine;
+
+namespace E2E.Tests.AgentObservationBudget;
+
+/// <summary>
+/// .NET-only: no upstream <c>it</c> covers where the budget is applied (upstream tests <c>observationByteBudget</c> as a function). These
+/// check the call sites: a judgment and an act cut the screen to the agent's limits, and a judgment over <c>MaxInputTokens</c> is refused
+/// before it is sent.
+/// </summary>
+public sealed class ObservationBudgetWiringTests
+{
+    [Fact]
+    public async Task A_judgment_cuts_a_screen_over_the_agents_MaxObservationBytes_and_marks_the_step_truncated()
+    {
+        var judge = new ScriptedModel(_ => ModelResponses.Done("passed", "ok"));
+        await using var session = await StartAsync(judge: judge, maxObservationBytes: 1_024);
+
+        await session.Context.App.OpenAsync("/");
+        await session.Context.Agent.AssertAsync("a button is on the page");
+        session.Complete(null);
+
+        var message = judge.Requests[0].Messages[0].Content!;
+        Assert.Contains("Button number 0", message, StringComparison.Ordinal);
+        Assert.DoesNotContain("Button number 299", message, StringComparison.Ordinal);
+        Assert.Contains(SnapshotText.TruncationMarker, message, StringComparison.Ordinal);
+        Assert.True(session.Steps.Single(step => step.Api == "agent.assert").ObservationTruncated);
+    }
+
+    [Fact]
+    public async Task A_judgment_over_the_agents_MaxInputTokens_fails_before_the_model_is_called()
+    {
+        var judge = new ScriptedModel(_ => ModelResponses.Done("passed", "ok"));
+        await using var session = await StartAsync(judge: judge, maxInputTokens: 1);
+
+        await session.Context.App.OpenAsync("/");
+        var error = await Assert.ThrowsAsync<AgentException>(() => session.Context.Agent.AssertAsync("a button is on the page"));
+        session.Complete(error);
+
+        Assert.Equal("STEP_BUDGET_EXHAUSTED", error.Code);
+        Assert.Contains("exceeds the agent's maxInputTokens 1", error.Message, StringComparison.Ordinal);
+        Assert.Equal(0, judge.CallCount);
+    }
+
+    [Fact]
+    public async Task An_act_cuts_the_screen_the_model_reads_to_the_agents_MaxObservationBytes()
+    {
+        var actor = new ScriptedModel(_ => ModelResponses.Done("passed", "done"));
+        await using var session = await StartAsync(actor: actor, maxObservationBytes: 1_024);
+
+        await session.Context.App.OpenAsync("/");
+        await session.Context.Agent.ActAsync("look at the page");
+        session.Complete(null);
+
+        var text = string.Join('\n', actor.Requests[0].Messages.Select(message => message.Content));
+        Assert.Contains(SnapshotText.TruncationMarker, text, StringComparison.Ordinal);
+        Assert.DoesNotContain("Button number 299", text, StringComparison.Ordinal);
+        Assert.True(session.Steps.Single(step => step.Api == "agent.act").ObservationTruncated);
+    }
+
+    private static async Task<E2ESession> StartAsync(ScriptedModel? actor = null, ScriptedModel? judge = null, int? maxObservationBytes = null, int? maxInputTokens = null) =>
+        await E2ESession.StartAsync(new E2ESessionOptions
+        {
+            Engine = new DocumentEngine(World()),
+            Model = actor,
+            Judge = judge,
+            MaxObservationBytes = maxObservationBytes ?? E2EDefaults.MaxObservationBytes,
+            MaxInputTokens = maxInputTokens ?? E2EDefaults.MaxInputTokens,
+            BaseUrl = "https://app.test",
+            TestTitle = "observation budget",
+            AssertionTimeout = TimeSpan.FromSeconds(2),
+            TestTimeout = TimeSpan.FromSeconds(10),
+            StepTimeout = TimeSpan.FromSeconds(5),
+        });
+
+    private static DocumentWorld World() => new DocumentWorld().Map("/", page =>
+    {
+        for (var index = 0; index < 300; index++)
+        {
+            page.Button("Button number " + index.ToString(CultureInfo.InvariantCulture));
+        }
+    });
+}
diff --git a/tests/E2E.Tests/AgentObservationBudget/ObservationByteBudgetTests.cs b/tests/E2E.Tests/AgentObservationBudget/ObservationByteBudgetTests.cs
new file mode 100644
index 00000000..b5f18e9a
--- /dev/null
+++ b/tests/E2E.Tests/AgentObservationBudget/ObservationByteBudgetTests.cs
@@ -0,0 +1,59 @@
+// Copyright 2026 TesterArmy.
+// Modified by Dario Kondratiuk.
+// SPDX-License-Identifier: Apache-2.0
+
+namespace E2E.Tests.AgentObservationBudget;
+
+/// <summary>Upstream's <c>describe('observationByteBudget')</c> (<c>tests/unit/agent-observation-budget.test.ts</c>).</summary>
+public sealed class ObservationByteBudgetTests
+{
+    private const int InstructionReserve = 4_096;
+
+    private static readonly ObservationBudgetLimits Limits = new(262_144, 200_000);
+
+    private static readonly int PixelReserve = ModelAdapter.ImageTokenUpperBound(2_560, 1_440);
+
+    [Fact]
+    public void Returns_the_configured_ceiling_when_the_request_leaves_room_for_it()
+    {
+        Assert.Equal(
+            262_144,
+            ObservationBudget.ObservationByteBudget(Limits with { MaxInputTokens = 1_000_000 }, new ObservationBudgetRequest(10_000, 0, false)));
+    }
+
+    [Fact]
+    public void Clamps_to_the_per_call_token_ceiling_minus_the_request_overhead()
+    {
+        const int fixedBytes = 100_000;
+        Assert.Equal(
+            Limits.MaxInputTokens - fixedBytes - InstructionReserve,
+            ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(fixedBytes, 0, false)));
+    }
+
+    [Fact]
+    public void Cuts_the_screen_by_the_measured_instruction_not_a_fixed_reserve()
+    {
+        const int fixedBytes = 100_000;
+        var shortBudget = ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(fixedBytes, 100, false));
+        var longBudget = ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(fixedBytes, 7_888, false));
+
+        Assert.Equal(7_788, shortBudget - longBudget);
+        Assert.Equal(Limits.MaxInputTokens - fixedBytes - 7_888 - InstructionReserve, longBudget);
+    }
+
+    [Fact]
+    public void Reserves_the_largest_planned_screenshot_on_a_vision_request()
+    {
+        const int fixedBytes = 100_000;
+        var text = ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(fixedBytes, 0, false));
+        var vision = ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(fixedBytes, 0, true));
+
+        Assert.Equal(PixelReserve, text - vision);
+    }
+
+    [Fact]
+    public void Never_falls_below_the_floor_a_tree_can_still_name_controls_under()
+    {
+        Assert.Equal(1_024, ObservationBudget.ObservationByteBudget(Limits, new ObservationBudgetRequest(1_000_000, 0, true)));
+    }
+}
diff --git a/tests/E2E.Tests/ConfigTests.cs b/tests/E2E.Tests/ConfigTests.cs
index 15ef29a9..580e3b35 100644
--- a/tests/E2E.Tests/ConfigTests.cs
+++ b/tests/E2E.Tests/ConfigTests.cs
@@ -148,16 +148,17 @@ public void Ci_reads_the_cache_and_retries_once_unless_configured()
     [InlineData("""{ "targets": [{ "platform": "web", "app": { "bundleId": "dev.x" } }] }""", "unknown targets[0].app key \"bundleId\"")]
     [InlineData("""{ "targets": [{ "platform": "android", "app": { "appPath": "" } }] }""", "targets[0].app.appPath must be a non-empty string")]
     [InlineData("""{ "agents": { "default": { "modle": "m" } } }""", "unknown agents.default key \"modle\"; did you mean \"model\"?")]
-    [InlineData("""{ "agents": { "default": { "maxInputTokens": 3 } } }""", "agents.default key \"maxInputTokens\" is not supported by the .NET port")]
+    [InlineData("""{ "agents": { "default": { "maxInputTokens": 0 } } }""", "agents.default.maxInputTokens must be an integer from 1 through 1000000")]
+    [InlineData("""{ "agents": { "default": { "maxObservationBytes": 1023 } } }""", "agents.default.maxObservationBytes must be an integer from 1024 through 16777216")]
     [InlineData("""{ "agents": { "default": { "tools": {} } } }""", "agents.default key \"tools\" is not supported by the .NET port")]
     [InlineData("""{ "agents": { "default": { "executor": {} } } }""", "agents.default key \"executor\" is not supported by the .NET port: an executor is code, so set AgentOptions.Executor")]
-    [InlineData("""{ "agents": { "default": { "maxSteps": 101 } } }""", "agents.default.maxSteps must be an integer from 1 to 100")]
-    [InlineData("""{ "agents": { "fast": { "maxModelCalls": 0 } } }""", "agents.fast.maxModelCalls must be an integer from 1 to 100")]
+    [InlineData("""{ "agents": { "default": { "maxSteps": 101 } } }""", "agents.default.maxSteps must be an integer from 1 through 100")]
+    [InlineData("""{ "agents": { "fast": { "maxModelCalls": 0 } } }""", "agents.fast.maxModelCalls must be an integer from 1 through 100")]
     [InlineData("""{ "agents": { "default": { "judgmentTimeout": 0 } } }""", "agents.default.judgmentTimeout must be a positive integer")]
     [InlineData("""{ "agents": { "default": { "system": 3 } } }""", "agents.default.system must be a string")]
     [InlineData("""{ "agents": { "default": { "providerOptions": { "openai": 1 } } } }""", "agents.default.providerOptions.openai must be an object of provider options")]
     [InlineData("""{ "timeout": 0 }""", "timeout must be a positive integer")]
-    [InlineData("""{ "retries": 11 }""", "retries must be an integer from 0 to 10")]
+    [InlineData("""{ "retries": 11 }""", "retries must be an integer from 0 through 10")]
     [InlineData("""{ "secrets": { "pin": "12345" } }""", "secret \"pin\" must be at least 6 characters")]
     [InlineData("""{ "secrets": { "token": null } }""", "secret \"token\" has no value; set E2E_SECRET_TOKEN")]
     [InlineData("""{ "secrets": { "api-key": "aaaaaa", "api_key": "bbbbbb" } }""", "share the override variable E2E_SECRET_API_KEY")]
diff --git a/tests/E2E.Tests/ReportStatus/ReportStatusBuilders.cs b/tests/E2E.Tests/ReportStatus/ReportStatusBuilders.cs
index bc8e11b6..bad74e28 100644
--- a/tests/E2E.Tests/ReportStatus/ReportStatusBuilders.cs
+++ b/tests/E2E.Tests/ReportStatus/ReportStatusBuilders.cs
@@ -34,7 +34,8 @@ public static Report1Document Build(
         ReportRunStatus status = ReportRunStatus.Failed,
         int exitCode = 1,
         IReadOnlyList<ReportError>? runErrors = null,
-        string? projectRoot = null) =>
+        string? projectRoot = null,
+        ReportLimits? limits = null) =>
         Valid(BuildReport.Build(new BuildReportOptions
         {
             RunId = Guid.CreateVersion7().ToString(),
@@ -44,6 +45,7 @@ public static Report1Document Build(
             Results = results ?? [],
             RunErrors = runErrors ?? [],
             ProjectRoot = projectRoot,
+            Limits = limits,
         }));
 
     private static Report1Document Valid(Report1Document document)
diff --git a/tests/E2E.Tests/ReportStatus/RunLimitsTests.cs b/tests/E2E.Tests/ReportStatus/RunLimitsTests.cs
index 474950f4..55c971f7 100644
--- a/tests/E2E.Tests/ReportStatus/RunLimitsTests.cs
+++ b/tests/E2E.Tests/ReportStatus/RunLimitsTests.cs
@@ -6,12 +6,26 @@
 
 namespace E2E.Tests.ReportStatus;
 
-/// <summary>
-/// Upstream's <c>describe('run limits')</c> (<c>tests/unit/report-status.test.ts</c>). Not ported: "fills the block from the largest
-/// per-agent values and the fixed ones", since the port's config rejects the agent keys <c>maxObservationBytes</c> and <c>maxInputTokens</c>.
-/// </summary>
+/// <summary>Upstream's <c>describe('run limits')</c> (<c>tests/unit/report-status.test.ts</c>).</summary>
 public sealed class RunLimitsTests
 {
+    private static readonly string Root = Path.Combine(Path.GetTempPath(), "e2e-run-limits-project");
+
+    /// <summary>Partial: upstream resolves the config with <c>cli: { agents: ['ux'] }</c> and builds the report from its <c>ResolvedConfig</c>. The port has no agent selection on a run, so the limits come from the config's agents (<c>ResolvedAgent.RunLimits</c>), which hold whichever one runs.</summary>
+    [Fact]
+    public void Partial_fills_the_block_from_the_largest_per_agent_values_and_the_fixed_ones_in_the_report_1_shape()
+    {
+        var config = E2EConfig.Parse(
+            """
+            { "agents": { "default": { "maxObservationBytes": 4096, "maxInputTokens": 200000 }, "ux": { "maxObservationBytes": 65536, "maxInputTokens": 8000 } } }
+            """,
+            Root,
+            _ => null);
+        var limits = ResolvedAgent.RunLimits(config.Agents.Select(pair => ResolvedAgent.From(pair.Key, pair.Value.CreateOptions())));
+
+        Assert.Equal(new ReportLimits(16_384, 8_192, 65_536, 1_000, 200_000), Build(limits: limits).Run.Limits);
+    }
+
     [Fact]
     public void Reports_the_defaults_when_the_run_failed_before_the_config_resolved()
     {

From d2f5ac63c8be8cdd506a9c5de444c4f318784d02 Mon Sep 17 00:00:00 2001
From: Dario Kondratiuk <dariokondratiuk@gmail.com>
Date: Mon, 26 Oct 2026 16:31:33 -0300
Subject: [PATCH 2/5] Render a look once for its size, the executor and the
 model

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DH1b4gwq2kmMK94pdZRQZm
---
 src/E2E/Agent/ObservationFeed.cs | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/E2E/Agent/ObservationFeed.cs b/src/E2E/Agent/ObservationFeed.cs
index 21e88a3c..862beac9 100644
--- a/src/E2E/Agent/ObservationFeed.cs
+++ b/src/E2E/Agent/ObservationFeed.cs
@@ -18,6 +18,11 @@ internal sealed class ObservationFeed(IEngineSession session, TimeProvider time)
     // Whether the executor-facing look in flight asked for pixels, which reserve part of the token ceiling the tree is cut under.
     private bool _pixels;
 
+    // The newest text rendered, which the same look reuses.
+    private Rendered? _rendered;
+
+    private sealed record Rendered(Observation Observation, bool Pixels, string Text, bool Cut);
+
     private readonly Dictionary<string, SemanticNode> _seen = [];
     private PendingChange? _pending;
 
@@ -208,6 +213,13 @@ internal ExecutorObservation View(Observation observation, AttemptScope scope, E
     /// <param name="cut">Whether the byte budget cut the screen.</param>
     public string Text(Observation observation, bool pixels, out bool cut)
     {
+        // One look is read for its size, for the executor, and for the model; it is rendered once.
+        if (_rendered is { } last && ReferenceEquals(last.Observation, observation) && last.Pixels == pixels)
+        {
+            cut = last.Cut;
+            return last.Text;
+        }
+
         var scope = Scope ?? throw new InvalidOperationException("This feed serves no executor.");
         var text = SnapshotText.Render(observation, scope.Redactor, scope.AppOrigin, ByteBudget(pixels), out cut);
         if (cut)
@@ -215,6 +227,7 @@ public string Text(Observation observation, bool pixels, out bool cut)
             _observationTruncated = true;
         }
 
+        _rendered = new Rendered(observation, pixels, text, cut);
         return text;
     }
 

From c095898591e297a6fd65cebed2bfe788c127eadc Mon Sep 17 00:00:00 2001
From: Dario Kondratiuk <dariokondratiuk@gmail.com>
Date: Mon, 26 Oct 2026 16:48:42 -0300
Subject: [PATCH 3/5] Keep the WebEngine and CopilotProvider API pages as on
 main (generated links to obj output)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DH1b4gwq2kmMK94pdZRQZm
---
 docs-site/src/content/docs/api/E2E.Engine/WebEngine.md      | 2 +-
 docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md b/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
index e496011a..974b57b8 100644
--- a/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
+++ b/docs-site/src/content/docs/api/E2E.Engine/WebEngine.md
@@ -28,7 +28,7 @@ same node actions the document engine does. Install browsers once with
 
 **Implements:** [IEngine](/api/E2E.Engine/IEngine/), [IAsyncDisposable](https://learn.microsoft.com/dotnet/api/system.iasyncdisposable)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L392)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L370)
 
 ## Constructors
 
diff --git a/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md b/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
index 69cc8dce..90f647f2 100644
--- a/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
+++ b/docs-site/src/content/docs/api/E2E.OAuth/CopilotProvider.md
@@ -27,7 +27,7 @@ expire; a 401 means signing in again.
 
 **Implements:** [IOAuthProvider](/api/E2E.OAuth/IOAuthProvider/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L1500)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/obj/Release/net10.0/System.Text.RegularExpressions.Generator/System.Text.RegularExpressions.Generator.RegexGenerator/RegexGenerator.g.cs#L1478)
 
 ## Constructors
 

From 502979c8ad02d1b823719fca59fad04c948f3557 Mon Sep 17 00:00:00 2001
From: Dario Kondratiuk <dariokondratiuk@gmail.com>
Date: Wed, 28 Oct 2026 19:26:53 -0300
Subject: [PATCH 4/5] Regenerate API docs after merging main

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 .../src/content/docs/api/E2E/AgentConfig.md   |  68 ++++++++---
 .../content/docs/api/E2E/AwsCredentials.md    |  10 +-
 .../src/content/docs/api/E2E/BedrockModel.md  |   8 +-
 .../docs/api/E2E/BedrockModelOptions.md       |  24 ++--
 .../src/content/docs/api/E2E/CacheConfig.md   |   8 +-
 .../src/content/docs/api/E2E/CacheMode.md     |   8 +-
 .../src/content/docs/api/E2E/E2EFixture.md    |  84 +++++++++----
 .../src/content/docs/api/E2E/E2ESession.md    |   8 +-
 .../content/docs/api/E2E/E2ESessionOptions.md | 114 ++++++++++++------
 .../src/content/docs/api/E2E/TargetConfig.md  |  12 +-
 10 files changed, 223 insertions(+), 121 deletions(-)

diff --git a/docs-site/src/content/docs/api/E2E/AgentConfig.md b/docs-site/src/content/docs/api/E2E/AgentConfig.md
index 0f1ea77b..9f6f8d04 100644
--- a/docs-site/src/content/docs/api/E2E/AgentConfig.md
+++ b/docs-site/src/content/docs/api/E2E/AgentConfig.md
@@ -25,7 +25,7 @@ Each entry starts from the defaults; none inherits another's values.
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L741)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L768)
 
 ## Fields
 
@@ -41,7 +41,7 @@ public const string DefaultProvider = "openai"
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L743)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L770)
 
 ## Properties
 
@@ -60,7 +60,7 @@ The environment variable holding the key. Unset, the one the provider reads, suc
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L774)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L801)
 
 <a id="E2E_AgentConfig_BaseUrl_"></a>
 <a id="E2E_AgentConfig_BaseUrl"></a>
@@ -77,7 +77,7 @@ The API root. Unset, the provider's own; for `azure` it is built from `AZURE_RES
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L771)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L798)
 
 <a id="E2E_AgentConfig_Context_"></a>
 <a id="E2E_AgentConfig_Context"></a>
@@ -94,7 +94,7 @@ Project context told to every model call, at most 16384 UTF-8 bytes.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L768)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L795)
 
 <a id="E2E_AgentConfig_Judge_"></a>
 <a id="E2E_AgentConfig_Judge"></a>
@@ -111,7 +111,7 @@ The model id that judges `assert`, `waitFor`, and `extract`. Unset, the judge is
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L759)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L786)
 
 <a id="E2E_AgentConfig_JudgmentTimeout_"></a>
 <a id="E2E_AgentConfig_JudgmentTimeout"></a>
@@ -126,7 +126,24 @@ public TimeSpan JudgmentTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L782)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L809)
+
+<a id="E2E_AgentConfig_MaxInputTokens_"></a>
+<a id="E2E_AgentConfig_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public int MaxInputTokens { get; init; }
+```
+
+
+1 through 1000000. See [MaxInputTokens](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxInputTokens).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L815)
 
 <a id="E2E_AgentConfig_MaxModelCalls_"></a>
 <a id="E2E_AgentConfig_MaxModelCalls"></a>
@@ -143,7 +160,24 @@ public int? MaxModelCalls { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L780)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L807)
+
+<a id="E2E_AgentConfig_MaxObservationBytes_"></a>
+<a id="E2E_AgentConfig_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public int MaxObservationBytes { get; init; }
+```
+
+
+1024 through 16777216. See [MaxObservationBytes](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxObservationBytes).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L812)
 
 <a id="E2E_AgentConfig_MaxSteps_"></a>
 <a id="E2E_AgentConfig_MaxSteps"></a>
@@ -160,7 +194,7 @@ public int? MaxSteps { get; init; }
 
 **Value:** [int?](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L777)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L804)
 
 <a id="E2E_AgentConfig_Model_"></a>
 <a id="E2E_AgentConfig_Model"></a>
@@ -175,7 +209,7 @@ public string? Model { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L756)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L783)
 
 <a id="E2E_AgentConfig_Provider_"></a>
 <a id="E2E_AgentConfig_Provider"></a>
@@ -192,7 +226,7 @@ Who serves [Model](#E2E_AgentConfig_Model) and [Judge](#E2E_AgentConfig_Judge).
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L762)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L789)
 
 <a id="E2E_AgentConfig_ProviderOptions_"></a>
 <a id="E2E_AgentConfig_ProviderOptions"></a>
@@ -209,7 +243,7 @@ Provider options by provider. Each client adds the entry under its own key to it
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L785)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L818)
 
 <a id="E2E_AgentConfig_Providers_"></a>
 <a id="E2E_AgentConfig_Providers"></a>
@@ -228,7 +262,7 @@ subscription logins (`chatgpt`, `copilot`, `grok`, `opencode-console`).
 
 **Value:** [IReadOnlyList&lt;string&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlylist-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L750)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L777)
 
 <a id="E2E_AgentConfig_System_"></a>
 <a id="E2E_AgentConfig_System"></a>
@@ -245,7 +279,7 @@ Text appended to the act rules. Judges never see it.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L765)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L792)
 
 ## Methods
 
@@ -264,7 +298,7 @@ The model for [Judge](#E2E_AgentConfig_Judge), or null when no judge is set.
 
 **Returns:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L791)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L824)
 
 <a id="E2E_AgentConfig_CreateModel_"></a>
 <a id="E2E_AgentConfig_CreateModel"></a>
@@ -281,7 +315,7 @@ The model for [Model](#E2E_AgentConfig_Model), or null when no model is set.
 
 **Returns:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L788)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L821)
 
 <a id="E2E_AgentConfig_CreateOptions_"></a>
 <a id="E2E_AgentConfig_CreateOptions"></a>
@@ -298,4 +332,4 @@ The [AgentOptions](/api/E2E/AgentOptions/) this entry describes, with its models
 
 **Returns:** [AgentOptions](/api/E2E/AgentOptions/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L794)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L827)
diff --git a/docs-site/src/content/docs/api/E2E/AwsCredentials.md b/docs-site/src/content/docs/api/E2E/AwsCredentials.md
index b5132595..969b628e 100644
--- a/docs-site/src/content/docs/api/E2E/AwsCredentials.md
+++ b/docs-site/src/content/docs/api/E2E/AwsCredentials.md
@@ -25,7 +25,7 @@ AWS access key credentials for Signature Version 4.
 
 **Implements:** [IEquatable&lt;AwsCredentials&gt;](https://learn.microsoft.com/dotnet/api/system.iequatable-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L311)
 
 ## Constructors
 
@@ -50,7 +50,7 @@ AWS access key credentials for Signature Version 4.
 | `SecretAccessKey` | [string](https://learn.microsoft.com/dotnet/api/system.string) |  |
 | `SessionToken` | [string](https://learn.microsoft.com/dotnet/api/system.string) |  |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L311)
 
 ## Properties
 
@@ -67,7 +67,7 @@ public string AccessKeyId { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L311)
 
 <a id="E2E_AwsCredentials_SecretAccessKey_"></a>
 <a id="E2E_AwsCredentials_SecretAccessKey"></a>
@@ -82,7 +82,7 @@ public string SecretAccessKey { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L311)
 
 <a id="E2E_AwsCredentials_SessionToken_"></a>
 <a id="E2E_AwsCredentials_SessionToken"></a>
@@ -97,4 +97,4 @@ public string? SessionToken { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L305)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L311)
diff --git a/docs-site/src/content/docs/api/E2E/BedrockModel.md b/docs-site/src/content/docs/api/E2E/BedrockModel.md
index a3c6ed80..b9c9a6ae 100644
--- a/docs-site/src/content/docs/api/E2E/BedrockModel.md
+++ b/docs-site/src/content/docs/api/E2E/BedrockModel.md
@@ -48,7 +48,7 @@ public BedrockModel(BedrockModelOptions options, HttpClient? httpClient = null)
 | `options` | [BedrockModelOptions](/api/E2E/BedrockModelOptions/) |  |
 | `httpClient` | [HttpClient](https://learn.microsoft.com/dotnet/api/system.net.http.httpclient) |  |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L24)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L27)
 
 ## Properties
 
@@ -67,7 +67,7 @@ Provider and model id, printed in the run summary. Changing it does not miss the
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L33)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L36)
 
 ## Methods
 
@@ -91,7 +91,7 @@ public Task<ModelResponse> CompleteAsync(ModelRequest request, CancellationToken
 
 **Returns:** [Task&lt;ModelResponse&gt;](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L35)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L38)
 
 <a id="E2E_BedrockModel_Dispose_"></a>
 <a id="E2E_BedrockModel_Dispose"></a>
@@ -106,4 +106,4 @@ public void Dispose()
 
 Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L69)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L75)
diff --git a/docs-site/src/content/docs/api/E2E/BedrockModelOptions.md b/docs-site/src/content/docs/api/E2E/BedrockModelOptions.md
index cf6926f2..ab1bb733 100644
--- a/docs-site/src/content/docs/api/E2E/BedrockModelOptions.md
+++ b/docs-site/src/content/docs/api/E2E/BedrockModelOptions.md
@@ -21,7 +21,7 @@ public sealed class BedrockModelOptions
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L254)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L260)
 
 ## Properties
 
@@ -40,7 +40,7 @@ A Bedrock API key, sent as a bearer token instead of signing.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L269)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L275)
 
 <a id="E2E_BedrockModelOptions_ApiKeyEnv_"></a>
 <a id="E2E_BedrockModelOptions_ApiKeyEnv"></a>
@@ -57,7 +57,7 @@ Environment variable read when [ApiKey](#E2E_BedrockModelOptions_ApiKey) is empt
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L272)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L278)
 
 <a id="E2E_BedrockModelOptions_BaseUrl_"></a>
 <a id="E2E_BedrockModelOptions_BaseUrl"></a>
@@ -74,7 +74,7 @@ The runtime endpoint. Unset, it is `https://bedrock-runtime.{region}.amazonaws.c
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L263)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L269)
 
 <a id="E2E_BedrockModelOptions_Credentials_"></a>
 <a id="E2E_BedrockModelOptions_Credentials"></a>
@@ -91,7 +91,7 @@ Signing credentials. Unset, they come from `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCE
 
 **Value:** [AwsCredentials](/api/E2E/AwsCredentials/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L275)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L281)
 
 <a id="E2E_BedrockModelOptions_MaxTokens_"></a>
 <a id="E2E_BedrockModelOptions_MaxTokens"></a>
@@ -106,7 +106,7 @@ public int MaxTokens { get; init; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L277)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L283)
 
 <a id="E2E_BedrockModelOptions_Model_"></a>
 <a id="E2E_BedrockModelOptions_Model"></a>
@@ -123,7 +123,7 @@ A Bedrock model id or inference profile, such as `us.anthropic.claude-sonnet-4-5
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L257)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L263)
 
 <a id="E2E_BedrockModelOptions_Provider_"></a>
 <a id="E2E_BedrockModelOptions_Provider"></a>
@@ -140,7 +140,7 @@ The key this client reads in [ProviderOptions](/api/E2E/ModelRequest/#E2E_ModelR
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L266)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L272)
 
 <a id="E2E_BedrockModelOptions_Region_"></a>
 <a id="E2E_BedrockModelOptions_Region"></a>
@@ -157,7 +157,7 @@ The AWS region. Unset, it is `AWS_REGION`, then `AWS_DEFAULT_REGION`, then `us-e
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L260)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L266)
 
 ## Methods
 
@@ -174,7 +174,7 @@ public string? ResolveApiKey()
 
 **Returns:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L279)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L285)
 
 <a id="E2E_BedrockModelOptions_ResolveCredentials_"></a>
 <a id="E2E_BedrockModelOptions_ResolveCredentials"></a>
@@ -189,7 +189,7 @@ public AwsCredentials? ResolveCredentials()
 
 **Returns:** [AwsCredentials](/api/E2E/AwsCredentials/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L289)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L295)
 
 <a id="E2E_BedrockModelOptions_ResolveRegion_"></a>
 <a id="E2E_BedrockModelOptions_ResolveRegion"></a>
@@ -204,4 +204,4 @@ public string ResolveRegion()
 
 **Returns:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L284)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Agent/Models/BedrockModel.cs#L290)
diff --git a/docs-site/src/content/docs/api/E2E/CacheConfig.md b/docs-site/src/content/docs/api/E2E/CacheConfig.md
index f57d0036..2f4e082b 100644
--- a/docs-site/src/content/docs/api/E2E/CacheConfig.md
+++ b/docs-site/src/content/docs/api/E2E/CacheConfig.md
@@ -21,7 +21,7 @@ public sealed class CacheConfig
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L886)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L921)
 
 ## Properties
 
@@ -40,7 +40,7 @@ Absolute cache directory. `cache.dir` resolves against the config directory; the
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L892)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L927)
 
 <a id="E2E_CacheConfig_Mode_"></a>
 <a id="E2E_CacheConfig_Mode"></a>
@@ -57,7 +57,7 @@ Unset, it is [ReadWrite](/api/E2E/CacheMode/#E2E_CacheMode_ReadWrite), or [ReadO
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L889)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L924)
 
 <a id="E2E_CacheConfig_Strict_"></a>
 <a id="E2E_CacheConfig_Strict"></a>
@@ -74,4 +74,4 @@ When true, a recording that no longer matches fails with `REPLAY_STALE` instead
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L895)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L930)
diff --git a/docs-site/src/content/docs/api/E2E/CacheMode.md b/docs-site/src/content/docs/api/E2E/CacheMode.md
index b3fe57a0..fab44c90 100644
--- a/docs-site/src/content/docs/api/E2E/CacheMode.md
+++ b/docs-site/src/content/docs/api/E2E/CacheMode.md
@@ -21,7 +21,7 @@ public enum CacheMode
 
 How the replay cache is used.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L899)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L934)
 
 ## Fields
 
@@ -39,7 +39,7 @@ Never read or write recordings.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L902)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L937)
 
 <a id="E2E_CacheMode_ReadOnly"></a>
 
@@ -55,7 +55,7 @@ Replay recordings, never write or delete them.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L905)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L940)
 
 <a id="E2E_CacheMode_ReadWrite"></a>
 
@@ -71,4 +71,4 @@ Replay recordings, record verified acts, and delete unverified ones.
 
 **Value:** [CacheMode](./)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L908)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L943)
diff --git a/docs-site/src/content/docs/api/E2E/E2EFixture.md b/docs-site/src/content/docs/api/E2E/E2EFixture.md
index 275af850..12a87162 100644
--- a/docs-site/src/content/docs/api/E2E/E2EFixture.md
+++ b/docs-site/src/content/docs/api/E2E/E2EFixture.md
@@ -50,7 +50,7 @@ protected virtual TimeSpan ActionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L147)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L153)
 
 <a id="E2E_E2EFixture_Agent_"></a>
 <a id="E2E_E2EFixture_Agent"></a>
@@ -153,7 +153,7 @@ in the AI SDK devtools shape. The process writes them to `ai-trace-<process id>.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L138)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L144)
 
 <a id="E2E_E2EFixture_App_"></a>
 <a id="E2E_E2EFixture_App"></a>
@@ -183,7 +183,7 @@ protected virtual TimeSpan AssertionTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L149)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L155)
 
 <a id="E2E_E2EFixture_BaseUrl_"></a>
 <a id="E2E_E2EFixture_BaseUrl"></a>
@@ -200,7 +200,7 @@ protected virtual string? BaseUrl { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L89)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L95)
 
 <a id="E2E_E2EFixture_Browser_"></a>
 <a id="E2E_E2EFixture_Browser"></a>
@@ -232,7 +232,7 @@ protected virtual string CacheDirectory { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L95)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L101)
 
 <a id="E2E_E2EFixture_CacheMode_"></a>
 <a id="E2E_E2EFixture_CacheMode"></a>
@@ -249,7 +249,7 @@ protected virtual CacheMode CacheMode { get; }
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L98)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L104)
 
 <a id="E2E_E2EFixture_CacheStrict_"></a>
 <a id="E2E_E2EFixture_CacheStrict"></a>
@@ -266,7 +266,7 @@ protected virtual bool CacheStrict { get; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L101)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L107)
 
 <a id="E2E_E2EFixture_CleanupTimeout_"></a>
 <a id="E2E_E2EFixture_CleanupTimeout"></a>
@@ -281,7 +281,7 @@ protected virtual TimeSpan CleanupTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L151)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L157)
 
 <a id="E2E_E2EFixture_Config_"></a>
 <a id="E2E_E2EFixture_Config"></a>
@@ -331,7 +331,7 @@ timings to stderr and keeps the transcript of every agent step. Override to turn
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L131)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L137)
 
 <a id="E2E_E2EFixture_JudgmentTimeout_"></a>
 <a id="E2E_E2EFixture_JudgmentTimeout"></a>
@@ -363,7 +363,24 @@ protected virtual TimeSpan LaunchTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L145)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L151)
+
+<a id="E2E_E2EFixture_MaxInputTokens_"></a>
+<a id="E2E_E2EFixture_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+protected virtual int MaxInputTokens { get; }
+```
+
+
+`agents.default.maxInputTokens`.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L89)
 
 <a id="E2E_E2EFixture_MaxModelCalls_"></a>
 <a id="E2E_E2EFixture_MaxModelCalls"></a>
@@ -380,7 +397,24 @@ protected virtual int MaxModelCalls { get; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L160)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L166)
+
+<a id="E2E_E2EFixture_MaxObservationBytes_"></a>
+<a id="E2E_E2EFixture_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+protected virtual int MaxObservationBytes { get; }
+```
+
+
+`agents.default.maxObservationBytes`.
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L86)
 
 <a id="E2E_E2EFixture_MaxSteps_"></a>
 <a id="E2E_E2EFixture_MaxSteps"></a>
@@ -397,7 +431,7 @@ protected virtual int MaxSteps { get; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L163)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L169)
 
 <a id="E2E_E2EFixture_ProjectRoot_"></a>
 <a id="E2E_E2EFixture_ProjectRoot"></a>
@@ -414,7 +448,7 @@ Anchors the files a test names, such as a route's fulfill path. Defaults to the
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L92)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L98)
 
 <a id="E2E_E2EFixture_ProviderOptions_"></a>
 <a id="E2E_E2EFixture_ProviderOptions"></a>
@@ -431,7 +465,7 @@ protected virtual IReadOnlyDictionary<string, JsonElement>? ProviderOptions { ge
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L86)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L92)
 
 <a id="E2E_E2EFixture_ReplayTimeout_"></a>
 <a id="E2E_E2EFixture_ReplayTimeout"></a>
@@ -448,7 +482,7 @@ How long a replay waits for each recorded target and for the recorded end state.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L157)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L163)
 
 <a id="E2E_E2EFixture_ResultsDirectory_"></a>
 <a id="E2E_E2EFixture_ResultsDirectory"></a>
@@ -465,7 +499,7 @@ Where a failed screenshot comparison puts its diff, actual, and expected images.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L110)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L116)
 
 <a id="E2E_E2EFixture_RunAgent_"></a>
 <a id="E2E_E2EFixture_RunAgent"></a>
@@ -532,7 +566,7 @@ How long one `ActAsync` may run unless its options say otherwise. A .NET-only se
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L154)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L160)
 
 <a id="E2E_E2EFixture_TargetName_"></a>
 <a id="E2E_E2EFixture_TargetName"></a>
@@ -549,7 +583,7 @@ protected virtual string TargetName { get; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L113)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L119)
 
 <a id="E2E_E2EFixture_TestTimeout_"></a>
 <a id="E2E_E2EFixture_TestTimeout"></a>
@@ -564,7 +598,7 @@ protected virtual TimeSpan TestTimeout { get; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L143)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L149)
 
 <a id="E2E_E2EFixture_Trace_"></a>
 <a id="E2E_E2EFixture_Trace"></a>
@@ -582,7 +616,7 @@ protected virtual ResolvedRecording Trace { get; }
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L119)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L125)
 
 <a id="E2E_E2EFixture_UpdateSnapshots_"></a>
 <a id="E2E_E2EFixture_UpdateSnapshots"></a>
@@ -600,7 +634,7 @@ finds missing or different, and passes. Override to turn it on in code.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L107)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L113)
 
 <a id="E2E_E2EFixture_Video_"></a>
 <a id="E2E_E2EFixture_Video"></a>
@@ -618,7 +652,7 @@ protected virtual ResolvedRecording Video { get; }
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L125)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L131)
 
 ## Methods
 
@@ -645,7 +679,7 @@ Does nothing when setup never started a session.
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L243)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L251)
 
 <a id="E2E_E2EFixture_CreateAgents_"></a>
 <a id="E2E_E2EFixture_CreateAgents"></a>
@@ -746,7 +780,7 @@ an `Expect.Soft` failure to the framework (null keeps them on the session), and
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L174)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L180)
 
 <a id="E2E_E2EFixture_TakeSession_"></a>
 <a id="E2E_E2EFixture_TakeSession"></a>
@@ -763,4 +797,4 @@ Hands the running session to the adapter to complete and dispose, or null when s
 
 **Returns:** [E2ESession](/api/E2E/E2ESession/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L246)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2EFixture.cs#L254)
diff --git a/docs-site/src/content/docs/api/E2E/E2ESession.md b/docs-site/src/content/docs/api/E2E/E2ESession.md
index fe6a74f1..05f8431e 100644
--- a/docs-site/src/content/docs/api/E2E/E2ESession.md
+++ b/docs-site/src/content/docs/api/E2E/E2ESession.md
@@ -222,7 +222,7 @@ looked at when the session is released. Only an attempt whose trace page is kept
 
 **Returns:** [Task](https://learn.microsoft.com/dotnet/api/system.threading.tasks.task)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L587)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L590)
 
 <a id="E2E_E2ESession_CloseSoftFailures_"></a>
 <a id="E2E_E2ESession_CloseSoftFailures"></a>
@@ -242,7 +242,7 @@ matchers throw as hard ones would.
 
 **Returns:** [TestException](/api/E2E/TestException/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L334)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L335)
 
 <a id="E2E_E2ESession_Complete_"></a>
 <a id="E2E_E2ESession_Complete_System_Exception_System_Threading_CancellationToken_"></a>
@@ -269,7 +269,7 @@ rewritten. A model outage leaves existing entries in place, unless a failure on
 | `error` | [Exception](https://learn.microsoft.com/dotnet/api/system.exception) |  |
 | `cancellationToken` | [CancellationToken](https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken) |  |
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L344)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L345)
 
 <a id="E2E_E2ESession_DisposeAsync_"></a>
 <a id="E2E_E2ESession_DisposeAsync"></a>
@@ -287,7 +287,7 @@ resetting unmanaged resources asynchronously.
 
 **Returns:** [ValueTask](https://learn.microsoft.com/dotnet/api/system.threading.tasks.valuetask) — A task that represents the asynchronous dispose operation.
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L363)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L364)
 
 <a id="E2E_E2ESession_Report_"></a>
 <a id="E2E_E2ESession_Report"></a>
diff --git a/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md b/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
index 3cd2ccd6..f12e91b7 100644
--- a/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
+++ b/docs-site/src/content/docs/api/E2E/E2ESessionOptions.md
@@ -23,7 +23,7 @@ How to open one [E2ESession](/api/E2E/E2ESession/). Retries set [Attempt](#E2E_E
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L808)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L812)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public TimeSpan ActionTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L886)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L896)
 
 <a id="E2E_E2ESessionOptions_Agent_"></a>
 <a id="E2E_E2ESessionOptions_Agent"></a>
@@ -57,7 +57,7 @@ The agent a call that names none uses, upstream's `agent` option of a test or ru
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L843)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L853)
 
 <a id="E2E_E2ESessionOptions_AgentContext_"></a>
 <a id="E2E_E2ESessionOptions_AgentContext"></a>
@@ -74,7 +74,7 @@ The default agent's upstream `context`: told to every model call, at most 16384
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L828)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L832)
 
 <a id="E2E_E2ESessionOptions_AgentExecutor_"></a>
 <a id="E2E_E2ESessionOptions_AgentExecutor"></a>
@@ -91,7 +91,7 @@ The default agent's custom brain, upstream's `executor`. See [Executor](/api/E2E
 
 **Value:** [IStepExecutor](/api/E2E/IStepExecutor/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L825)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L829)
 
 <a id="E2E_E2ESessionOptions_AgentSystem_"></a>
 <a id="E2E_E2ESessionOptions_AgentSystem"></a>
@@ -108,7 +108,7 @@ The default agent's upstream `system`: text appended to the act rules. Judges ne
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L819)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L823)
 
 <a id="E2E_E2ESessionOptions_AgentTools_"></a>
 <a id="E2E_E2ESessionOptions_AgentTools"></a>
@@ -125,7 +125,7 @@ The default agent's project tools, offered to the model beside the agent's own.
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentTool&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L822)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L826)
 
 <a id="E2E_E2ESessionOptions_Agents_"></a>
 <a id="E2E_E2ESessionOptions_Agents"></a>
@@ -143,7 +143,7 @@ Each starts from the built-in defaults, not from the default agent.
 
 **Value:** [IReadOnlyDictionary&lt;string, AgentOptions&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L840)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L850)
 
 <a id="E2E_E2ESessionOptions_AiTrace_"></a>
 <a id="E2E_E2ESessionOptions_AiTrace"></a>
@@ -161,7 +161,7 @@ shape and added to `ai-trace-<process id>.json` next to the results directory (`
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L948)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L958)
 
 <a id="E2E_E2ESessionOptions_AssertionTimeout_"></a>
 <a id="E2E_E2ESessionOptions_AssertionTimeout"></a>
@@ -176,7 +176,7 @@ public TimeSpan AssertionTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L888)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L898)
 
 <a id="E2E_E2ESessionOptions_Attempt_"></a>
 <a id="E2E_E2ESessionOptions_Attempt"></a>
@@ -193,7 +193,7 @@ public int Attempt { get; init; }
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L954)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L964)
 
 <a id="E2E_E2ESessionOptions_BaseUrl_"></a>
 <a id="E2E_E2ESessionOptions_BaseUrl"></a>
@@ -208,7 +208,7 @@ public string? BaseUrl { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L848)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L858)
 
 <a id="E2E_E2ESessionOptions_Cache_"></a>
 <a id="E2E_E2ESessionOptions_Cache"></a>
@@ -223,7 +223,7 @@ public IStepCache? Cache { get; init; }
 
 **Value:** [IStepCache](/api/E2E/IStepCache/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L853)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L863)
 
 <a id="E2E_E2ESessionOptions_CacheEnabled_"></a>
 <a id="E2E_E2ESessionOptions_CacheEnabled"></a>
@@ -238,7 +238,7 @@ public bool CacheEnabled { get; init; }
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L855)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L865)
 
 <a id="E2E_E2ESessionOptions_CacheMode_"></a>
 <a id="E2E_E2ESessionOptions_CacheMode"></a>
@@ -255,7 +255,7 @@ public CacheMode CacheMode { get; init; }
 
 **Value:** [CacheMode](/api/E2E/CacheMode/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L858)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L868)
 
 <a id="E2E_E2ESessionOptions_CacheStrict_"></a>
 <a id="E2E_E2ESessionOptions_CacheStrict"></a>
@@ -274,7 +274,7 @@ Retries replay too, and the session never writes or deletes a recording, whateve
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L865)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L875)
 
 <a id="E2E_E2ESessionOptions_CleanupTimeout_"></a>
 <a id="E2E_E2ESessionOptions_CleanupTimeout"></a>
@@ -291,7 +291,7 @@ How long the engine may take to shut down on dispose. Upstream `cleanupTimeout`.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L871)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L881)
 
 <a id="E2E_E2ESessionOptions_Debug_"></a>
 <a id="E2E_E2ESessionOptions_Debug"></a>
@@ -309,7 +309,7 @@ and action phases, writes the table to stderr when it is released, and keeps eac
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L942)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L952)
 
 <a id="E2E_E2ESessionOptions_Engine_"></a>
 <a id="E2E_E2ESessionOptions_Engine"></a>
@@ -324,7 +324,7 @@ public required IEngine Engine { get; init; }
 
 **Value:** [IEngine](/api/E2E.Engine/IEngine/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L810)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L814)
 
 <a id="E2E_E2ESessionOptions_Judge_"></a>
 <a id="E2E_E2ESessionOptions_Judge"></a>
@@ -341,7 +341,7 @@ The default agent's judge for `assert`, `waitFor`, and `extract`. Defaults to [M
 
 **Value:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L816)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L820)
 
 <a id="E2E_E2ESessionOptions_JudgmentTimeout_"></a>
 <a id="E2E_E2ESessionOptions_JudgmentTimeout"></a>
@@ -358,7 +358,7 @@ The default agent's `judgmentTimeout`: the deadline of one `assert`, `waitFor`,
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L831)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L835)
 
 <a id="E2E_E2ESessionOptions_LaunchTimeout_"></a>
 <a id="E2E_E2ESessionOptions_LaunchTimeout"></a>
@@ -375,7 +375,24 @@ How long the engine may take to start. Upstream `launchTimeout`.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L868)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L878)
+
+<a id="E2E_E2ESessionOptions_MaxInputTokens_"></a>
+<a id="E2E_E2ESessionOptions_MaxInputTokens"></a>
+
+### MaxInputTokens
+
+
+```csharp
+public int MaxInputTokens { get; init; }
+```
+
+
+The default agent's `maxInputTokens`. See [MaxInputTokens](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxInputTokens).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L841)
 
 <a id="E2E_E2ESessionOptions_MaxModelCalls_"></a>
 <a id="E2E_E2ESessionOptions_MaxModelCalls"></a>
@@ -392,7 +409,24 @@ The default agent's model calls per agent call, 1 through 100.
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L897)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L907)
+
+<a id="E2E_E2ESessionOptions_MaxObservationBytes_"></a>
+<a id="E2E_E2ESessionOptions_MaxObservationBytes"></a>
+
+### MaxObservationBytes
+
+
+```csharp
+public int MaxObservationBytes { get; init; }
+```
+
+
+The default agent's `maxObservationBytes`. See [MaxObservationBytes](/api/E2E/AgentOptions/#E2E_AgentOptions_MaxObservationBytes).
+
+**Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
+
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L838)
 
 <a id="E2E_E2ESessionOptions_MaxSteps_"></a>
 <a id="E2E_E2ESessionOptions_MaxSteps"></a>
@@ -409,7 +443,7 @@ Actions one `ActAsync` may take, 1 through 100. [MaxSteps](/api/E2E/ActOptions/#
 
 **Value:** [int](https://learn.microsoft.com/dotnet/api/system.int32)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L900)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L910)
 
 <a id="E2E_E2ESessionOptions_Model_"></a>
 <a id="E2E_E2ESessionOptions_Model"></a>
@@ -426,7 +460,7 @@ The default agent's model.
 
 **Value:** [IAgentModel](/api/E2E/IAgentModel/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L813)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L817)
 
 <a id="E2E_E2ESessionOptions_OnSoftFailure_"></a>
 <a id="E2E_E2ESessionOptions_OnSoftFailure"></a>
@@ -444,7 +478,7 @@ on the session until [CloseSoftFailures()](/api/E2E/E2ESession/#E2E_E2ESession_C
 
 **Value:** [Action&lt;TestException&gt;](https://learn.microsoft.com/dotnet/api/system.action-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L906)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L916)
 
 <a id="E2E_E2ESessionOptions_ProjectRoot_"></a>
 <a id="E2E_E2ESessionOptions_ProjectRoot"></a>
@@ -461,7 +495,7 @@ Anchors the files a test names, such as a route's fulfill `Path`. Defaults to th
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L851)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L861)
 
 <a id="E2E_E2ESessionOptions_ProviderOptions_"></a>
 <a id="E2E_E2ESessionOptions_ProviderOptions"></a>
@@ -478,7 +512,7 @@ The default agent's provider options, keyed by provider. See [ProviderOptions](/
 
 **Value:** [IReadOnlyDictionary&lt;string, JsonElement&gt;](https://learn.microsoft.com/dotnet/api/system.collections.generic.ireadonlydictionary-2)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L834)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L844)
 
 <a id="E2E_E2ESessionOptions_ReplayTimeout_"></a>
 <a id="E2E_E2ESessionOptions_ReplayTimeout"></a>
@@ -495,7 +529,7 @@ How long a replay waits for each recorded target and for the recorded end state.
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L894)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L904)
 
 <a id="E2E_E2ESessionOptions_ResultsDirectory_"></a>
 <a id="E2E_E2ESessionOptions_ResultsDirectory"></a>
@@ -512,7 +546,7 @@ Where a failed screenshot comparison puts its diff, actual, and expected images.
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L924)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L934)
 
 <a id="E2E_E2ESessionOptions_StepTimeout_"></a>
 <a id="E2E_E2ESessionOptions_StepTimeout"></a>
@@ -529,7 +563,7 @@ How long one `ActAsync` may run unless [Timeout](/api/E2E/ActOptions/#E2E_ActOpt
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L891)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L901)
 
 <a id="E2E_E2ESessionOptions_TargetName_"></a>
 <a id="E2E_E2ESessionOptions_TargetName"></a>
@@ -546,7 +580,7 @@ The target's name in a stored screenshot's file name. Defaults to the engine's p
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L915)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L925)
 
 <a id="E2E_E2ESessionOptions_TestAgentContext_"></a>
 <a id="E2E_E2ESessionOptions_TestAgentContext"></a>
@@ -563,7 +597,7 @@ Upstream's `agentContext` of a test or group: appended to the context of every a
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L846)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L856)
 
 <a id="E2E_E2ESessionOptions_TestFailed_"></a>
 <a id="E2E_E2ESessionOptions_TestFailed"></a>
@@ -581,7 +615,7 @@ verifies acts, so a teardown assertion after a failure does not record them.
 
 **Value:** [Func&lt;bool&gt;](https://learn.microsoft.com/dotnet/api/system.func-1)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L912)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L922)
 
 <a id="E2E_E2ESessionOptions_TestFile_"></a>
 <a id="E2E_E2ESessionOptions_TestFile"></a>
@@ -602,7 +636,7 @@ alone as the identity and adds no title line, as for an `e2e mcp` session, which
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L882)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L892)
 
 <a id="E2E_E2ESessionOptions_TestTimeout_"></a>
 <a id="E2E_E2ESessionOptions_TestTimeout"></a>
@@ -617,7 +651,7 @@ public TimeSpan TestTimeout { get; init; }
 
 **Value:** [TimeSpan](https://learn.microsoft.com/dotnet/api/system.timespan)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L884)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L894)
 
 <a id="E2E_E2ESessionOptions_TestTitle_"></a>
 <a id="E2E_E2ESessionOptions_TestTitle"></a>
@@ -632,7 +666,7 @@ public required string TestTitle { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L873)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L883)
 
 <a id="E2E_E2ESessionOptions_Trace_"></a>
 <a id="E2E_E2ESessionOptions_Trace"></a>
@@ -649,7 +683,7 @@ Which attempts record a trace. The session only carries the setting; [Attempt](#
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L933)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L943)
 
 <a id="E2E_E2ESessionOptions_UpdateSnapshots_"></a>
 <a id="E2E_E2ESessionOptions_UpdateSnapshots"></a>
@@ -667,7 +701,7 @@ different, and passes.
 
 **Value:** [bool](https://learn.microsoft.com/dotnet/api/system.boolean)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L921)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L931)
 
 <a id="E2E_E2ESessionOptions_Video_"></a>
 <a id="E2E_E2ESessionOptions_Video"></a>
@@ -684,4 +718,4 @@ Which attempts record a video. The session only carries the setting; [Attempt](#
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L936)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Run/E2ESession.cs#L946)
diff --git a/docs-site/src/content/docs/api/E2E/TargetConfig.md b/docs-site/src/content/docs/api/E2E/TargetConfig.md
index 4196fad2..a9053dae 100644
--- a/docs-site/src/content/docs/api/E2E/TargetConfig.md
+++ b/docs-site/src/content/docs/api/E2E/TargetConfig.md
@@ -23,7 +23,7 @@ One entry of `targets`. The port drives the `web`, `ios`, and `android` platform
 
 **Inheritance:** [object](https://learn.microsoft.com/dotnet/api/system.object)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L670)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L697)
 
 ## Properties
 
@@ -40,7 +40,7 @@ public required AppConfig App { get; init; }
 
 **Value:** [AppConfig](/api/E2E/AppConfig/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L676)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L703)
 
 <a id="E2E_TargetConfig_Name_"></a>
 <a id="E2E_TargetConfig_Name"></a>
@@ -55,7 +55,7 @@ public required string Name { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L672)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L699)
 
 <a id="E2E_TargetConfig_Platform_"></a>
 <a id="E2E_TargetConfig_Platform"></a>
@@ -70,7 +70,7 @@ public required string Platform { get; init; }
 
 **Value:** [string](https://learn.microsoft.com/dotnet/api/system.string)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L674)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L701)
 
 <a id="E2E_TargetConfig_Trace_"></a>
 <a id="E2E_TargetConfig_Trace"></a>
@@ -87,7 +87,7 @@ Which attempts write `trace.md`: `E2E_TRACE`, else this target's `trace`, else t
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L682)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L709)
 
 <a id="E2E_TargetConfig_Video_"></a>
 <a id="E2E_TargetConfig_Video"></a>
@@ -104,4 +104,4 @@ Which attempts record a video: `E2E_VIDEO`, else this target's `video`, else the
 
 **Value:** [ResolvedRecording](/api/E2E/ResolvedRecording/)
 
-[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L685)
+[View source](https://github.com/hardkoded/e2e-dotnet/blob/main/src/E2E/Config/E2EConfig.cs#L712)

From 0aa370031c4beeb8487f70256428bdc739b2d8bf Mon Sep 17 00:00:00 2001
From: Dario Kondratiuk <dariokondratiuk@gmail.com>
Date: Thu, 29 Oct 2026 15:15:33 -0300
Subject: [PATCH 5/5] Limit the maxInputTokens preflight claim to built-in
 judgments

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
---
 skills/e2e-dotnet/SKILL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/skills/e2e-dotnet/SKILL.md b/skills/e2e-dotnet/SKILL.md
index 3eae1c8e..911c4f31 100644
--- a/skills/e2e-dotnet/SKILL.md
+++ b/skills/e2e-dotnet/SKILL.md
@@ -249,7 +249,7 @@ lines you changed:
   use, `system` for how it works, named agents under `agents`. A screen over
   the agent's `maxObservationBytes` (default 262144) is cut with an
   `[observation truncated ...]` marker, and a request over `maxInputTokens`
-  (default 64000) fails before the model call (topic `agent`). A different brain
+  (default 64000) fails before the model call of a built-in judgment; a custom `ToolLoop` sends its own requests and is not checked first (topic `agent`). A different brain
   is an executor: your own tools in a `ToolLoop`, or an `IStepExecutor` (topic
   `agent`). Every built-in prompt of a test opens with the test's title
   (`Test: <name>`), judges included (a custom executor reads `context.Attempt.TitlePath`), so name a test for what it covers, not