fix(agentic): deduplicate forwarded test ID targets (MetaMask#35762)

## **Description**

React can forward one `testID` and press handler through several fibers.
`pressTestId` now collapses only nested matches that share the same
handler, disabled state, and measured native target. Distinct nested or
sibling controls remain ambiguous and fail closed.

## **Changelog**

CHANGELOG entry: null

## **Related issues**

Refs: https://consensyssoftware.atlassian.net/browse/TAT-3919

Follow-up to MetaMask#35746 and
MetaMask/experimental-metamask-harness#207.

## **Manual testing steps**

```gherkin
Feature: Agentic press target resolution

  Scenario: Press a test ID forwarded through nested React fibers
    Given a Mobile dev build exposes one control through nested fibers
    When a Recipe v1 flow presses the forwarded test ID
    Then the control is pressed exactly once
    And distinct nested controls remain ambiguous
```

Validation:

- `yarn jest app/dev-tools/AgenticService/AgenticService.test.ts
--no-coverage`
- `yarn lint:tsc`
- `yarn eslint --quiet app/dev-tools/AgenticService/AgenticService.ts
app/dev-tools/AgenticService/AgenticService.test.ts`
- Live iOS advanced-order recipe: 134/134 nodes passed on commit
`9c7554f2bf` source.

## **Screenshots/Recordings**

### **Before**

N/A. This changes a development-only control bridge.

### **After**

N/A. The bridge has no visible UI. Live iOS proof showed an active TWAP
card, a Chase row at `Running · 0%`, and all three Scale child orders.

## **Pre-merge author checklist**

- [x] I've followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [x] I've completed the PR template to the best of my ability
- [x] I've included tests if applicable
- [x] I've documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [x] I've applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

#### Performance checks (if applicable)

- [x] I've tested on Android
  - Ideally on a mid-range device; emulator is acceptable
- [x] I've tested with a power user scenario
- Use these [power-user
SRPs](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/edit-v2/401401446401?draftShareId=9d77e1e1-4bdc-4be1-9ebb-ccd916988d93)
to import wallets with many accounts and tokens
- [x] I've instrumented key operations with Sentry traces for production
performance metrics
- See [`trace()`](/app/util/trace.ts) for usage and
[`addToken`](/app/components/Views/AddAsset/components/AddCustomToken/AddCustomToken.tsx#L274)
for an example

For performance guidelines and tooling, see the [Performance
Guide](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/400085549067/Performance+Guide+for+Engineers).

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.

<!-- Generated with the help of the pr-description AI skill -->

Author: abretonc7s

app/dev-tools/AgenticService/AgenticService.test.ts

@@ -902,6 +902,53 @@ describe('AgenticService.install', () => {
       expect(visiblePress).toHaveBeenCalledTimes(1);
     });
 
+    it('presses one control whose test ID is forwarded through nested fibers', async () => {
+      const onPress = jest.fn();
+      const stateNode = {
+        measureInWindow: (callback) => callback(10, 10, 40, 40),
+      } as FiberNode['stateNode'];
+      const innerTarget = makeFiber({
+        testID: 'forwarded-button',
+        onPress,
+        stateNode,
+      });
+      const outerTarget = makeFiber({
+        testID: 'forwarded-button',
+        onPress,
+        child: innerTarget,
+      });
+      innerTarget.return = outerTarget;
+      installFiberHook(makeFiber({ child: outerTarget }));
+
+      const result = await bridge().pressTestId('forwarded-button');
+
+      expect(result).toEqual({ ok: true, testId: 'forwarded-button' });
+      expect(onPress).toHaveBeenCalledTimes(1);
+    });
+
+    it('does not collapse nested controls with different press handlers', async () => {
+      const outerPress = jest.fn();
+      const innerPress = jest.fn();
+      const innerTarget = makeFiber({
+        testID: 'nested-button',
+        onPress: innerPress,
+      });
+      const outerTarget = makeFiber({
+        testID: 'nested-button',
+        onPress: outerPress,
+        child: innerTarget,
+      });
+      innerTarget.return = outerTarget;
+      installFiberHook(makeFiber({ child: outerTarget }));
+
+      const result = await bridge().pressTestId('nested-button');
+
+      expect(result.ok).toBe(false);
+      expect(result.error).toContain('duplicate matches');
+      expect(outerPress).not.toHaveBeenCalled();
+      expect(innerPress).not.toHaveBeenCalled();
+    });
+
     it('does not borrow a visible frame from a duplicate sibling', async () => {
       const unmeasurablePress = jest.fn();
       const visiblePress = jest.fn();

app/dev-tools/AgenticService/AgenticService.ts

@@ -367,6 +367,31 @@ function findFiberByTestId(
   return result;
 }
 
+/**
+ * Collapse matching fibers nested on the same component path. React forwards
+ * props through composite components, so one rendered control can expose the
+ * same testID and press handler on several ancestor/descendant fibers.
+ */
+function collapseNestedFibers(fibers: FiberNode[]): FiberNode[] {
+  const candidates = new Set(fibers);
+  return fibers.filter((fiber) => {
+    let ancestor = fiber.return;
+    while (ancestor) {
+      if (
+        candidates.has(ancestor) &&
+        ancestor.memoizedProps?.onPress === fiber.memoizedProps?.onPress &&
+        isFiberDisabled(ancestor) === isFiberDisabled(fiber) &&
+        findMeasurableStateNode(ancestor, false) ===
+          findMeasurableStateNode(fiber, false)
+      ) {
+        return false;
+      }
+      ancestor = ancestor.return;
+    }
+    return true;
+  });
+}
+
 /**
  * Iterate all React renderer roots and call `visitor` on each root fiber.
  * Returns true if any visitor call returns true.
@@ -1217,9 +1242,10 @@ const AgenticService = {
             });
             return false;
           });
+          const distinctCandidates = collapseNestedFibers(candidates);
           const viewport = Dimensions.get('window');
           const measuredCandidates = await Promise.all(
-            candidates.map(async (fiber) => ({
+            distinctCandidates.map(async (fiber) => ({
               fiber,
               rect: await measureStateNode(
                 findMeasurableStateNode(fiber, false),
@@ -1239,13 +1265,13 @@ const AgenticService = {
           )?.fiber;
           const candidate =
             visibleCandidate ??
-            (candidates.length === 1 ? candidates[0] : null);
+            (distinctCandidates.length === 1 ? distinctCandidates[0] : null);
           if (!candidate) {
             return {
               ok: false,
               testId,
               error:
-                candidates.length > 1
+                distinctCandidates.length > 1
                   ? `No visible component with testID="${testId}" found among duplicate matches`
                   : `No component with testID="${testId}" found or no onPress prop`,
             };