Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/ops-agent-operations.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@fluentui-react-native/desktop-driver': patch
---

Fix the agent operations. Observation paging and deltas no longer re-serialize the tree for every candidate, and a delta no longer issues references it does not return or for removed elements. `sequence` refuses a whole request up front for selector content the operator denies and for a `clear` the session's strict input mode cannot perform, which the service now always reports from its mode and the target's features instead of leaving it permissive. `act` names the proven reference and reports an unsupported `enabled` or `visible` state as `state-unsupported`, reports provider failures in fixed words, and reports a click that raised the window before failing as partial instead of rejected. `check` ends on an unsupported fact and spaces its evaluations. Malformed references and unknown fields no longer echo caller text, session capacities outside their ranges are rejected instead of clamped, and `complete` and `truncation` mean the same on `find`, `journal`, and `stories`, which now always reports both. Document the missing failure reasons and `furn:inputMode`, and correct the `/agent` README row, which is not bounded.
5 changes: 5 additions & 0 deletions .changeset/srv-server-hardening.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
'@fluentui-react-native/desktop-driver': patch
---

Harden the Desktop Driver server fences, capabilities and recovery. The named accessibility action route enforces the Storybook preview-context fence like click, clear and value, and story select and reset find the story root in any session window. Closing a session releases held input even when the settlement journal is down, leaves the application open if the release did not run, and lifts a launched application's quarantine only when a probe reports it exited. The journal adopts a record that storage created before failing, treats an absent record as removed, and bounds every storage and probe call. Unknown or mistyped `furn:` capabilities are rejected, and `furn:launchMode` is returned. Browser rejection also requires a loopback `Host` and no browser Fetch Metadata, the listener must bind a loopback address and keeps a permanent error handler. Startup options are validated strictly. A target registered after startup reads its journal before it is reported or opened. Timeouts are validated together, reject unsafe integers, accept a `null` script timeout, and an implicit wait ends when the session is deleted. Malformed percent-encoding is `invalid argument`, an unknown `/furn/*` route is `unknown command`, and `POST /window/new` is `unsupported operation`.
2 changes: 1 addition & 1 deletion packages/agentic/desktop-driver/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,7 +157,7 @@ The [reference index](references/README.md) describes each package-owned guide.
| `/authority` | Grants, private connection descriptors, and macOS owner-validated storage |
| `/native` | Native-helper build, resolution, and verification without loading the package root |
| `/server` | Embeddable remote end, session manager, and target registry |
| `/agent` | Bounded JSON-safe inspection, action, and evidence API |
| `/agent` | JSON-safe API; `describe` and `agent describe` trim an unbounded whole-tree read |
| `/operations` | Versioned agent operation catalog, executor, and result types |
| `/artifacts` | Confined, atomic evidence persistence |
| `/runner` | Plan selection, sharding, execution, and result classification |
Expand Down
2 changes: 1 addition & 1 deletion packages/agentic/desktop-driver/references/architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,7 +135,7 @@ handoff are still work in progress; see [current status](current-status.md).
| `src/authoring` | Serializable story plans, selectors, capabilities, results, and case descriptors |
| `src/runner` | Filtering, sharding, execution, and result classification |
| `src/artifacts` | Confined atomic evidence |
| `src/agent` | Bounded JSON-safe operations |
| `src/agent` | JSON-safe agent API; `describe` trims an unbounded whole-tree read |
| `src/operations` | Agent operation catalog, executor, references, ledger, and journal |
| `src/testing` | Fake harnesses and Storybook test doubles |
| `src/cli` | Commander parsing, JSON output, and process exit adaptation |
Expand Down
2 changes: 1 addition & 1 deletion packages/agentic/desktop-driver/references/contributing.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ change-oriented guidance.
| `src/wdio` | Sanctioned WebdriverIO connection and commands |
| `src/client` | Low-level typed W3C client |
| `src/authority` | Grants, private discovery records, and platform ownership adapters |
| `src/agent` | Bounded agent-facing operations |
| `src/agent` | JSON-safe agent API; `describe` trims an unbounded tree read |
| `src/operations` | Versioned agent operations, references, release ledger, and journal |
| `src/artifacts` | Evidence naming, confinement, and atomic writes |
| `src/testing` | Reusable fake harnesses, never production fallback |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ and its sub-issues, which record dependencies and parallel waves.
| Bounded observation, references, paging, deltas | Done | Provider capability/budget checks, explicit completeness and truncation. Reference generation is session-local; reopen after application replacement. |
| Find, action, check, sequence | Done | Up to eight sequence steps; request-id outcomes prevent replay within their retained session history. No replay across service replacement. |
| Capture and artifact pages | Done | Session-bound bounded artifacts and hashes; pixels are opt-in. Screenshots are evidence, not visual comparison. |
| Named accessibility actions | Done in agent operations | WDIO can list actions but has no corresponding named-action invocation command. |
| Named accessibility actions | Done | Agent operations and WDIO (`desktopPerformAccessibilityAction`) invoke one uniquely named action; the W3C route is fenced against stale Storybook preview context like click, clear and value. |
| Story catalog/select/reset | Done, experimental integration | Local lifetime/signal context, authenticated epochs persisted per native-verified app incarnation, versioned marker conformance, prompt disconnect failure, and stale preview rejection. Bounded macOS Paper/Fabric marker and stale-reference checks passed at `6fca14788`; native cancellation/fault injection remain unqualified. Unknown navigation effects still quarantine. |
| Story args on protected driver | Intentionally unsupported | `story-args-unsupported`, including the session-owning grant and controlled orchestrator. HTTP and foreign WebSocket args are refused/not relayed without logging values; legacy unprotected args remain separate. |
| Exclusive Storybook control | Work in progress: native qualification | Deterministic endpoint evidence: controlled HTTP mutations return 403; foreign WS selection/prepare/args never reach the runtime; authenticated driver prepare/select uses F4 settlement and fencing. Non-agent channel remains legacy unprotected. Native endpoint evidence not yet run: macOS Paper/Fabric, Windows Fabric/Win32 Paper. Preview context checks preserve chrome/secondary references. |
Expand Down
Loading
Loading