export getAccessibilityTree() with deprecation warning

[seanmcguire12]

why

• to make this util available, but with a cautionary warning that extract() usage is the stable alternative

what changed

• exported getAccessibilityTree() and its return type through index.ts

---

Summary by cubic

Expose getAccessibilityTree() in the public API for troubleshooting the AX tree, and export its TreeResult type. The helper is marked deprecated; prefer extract() for supported usage.

^{Written for commit 01f43da. Summary will update automatically on new commits.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 01f43da

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[cubic-dev-ai]

No issues found across 3 files

[greptile-apps]

Greptile Overview

Greptile Summary

Exports getAccessibilityTree() utility function as an escape hatch for troubleshooting accessibility tree retrieval, with appropriate deprecation warnings recommending users prefer extract() for stable usage.

• Added TreeResult type export for proper typing of the return value
• Added @deprecated JSDoc comment in lib/a11y/utils.ts to warn developers
• Added deprecation comment at the export site in lib/index.ts

Confidence Score: 5/5

• This PR is safe to merge - it simply exposes an existing internal utility with appropriate deprecation warnings.
• The changes are minimal and well-documented: adds JSDoc deprecation to an existing function and exports it along with its return type. No logic changes, no breaking changes to existing functionality.
• No files require special attention.

Important Files Changed

File Analysis

Filename	Score	Overview
.changeset/whole-ducks-yell.md	5/5	Standard changeset file for patch release documenting the getAccessibilityTree() export.
lib/a11y/utils.ts	5/5	Added @deprecated JSDoc to getAccessibilityTree() warning users to prefer extract() for stable usage.
lib/index.ts	5/5	Exports getAccessibilityTree and TreeResult type with deprecation warning. Function requires StagehandPage which is not publicly exported, limiting external usability.

Sequence Diagram

sequenceDiagram
    participant User
    participant Stagehand
    participant getAccessibilityTree
    participant CDP as Chrome DevTools Protocol

    User->>Stagehand: import { getAccessibilityTree }
    Note over User: Deprecated - prefer extract()
    User->>getAccessibilityTree: Call with StagehandPage, logger
    getAccessibilityTree->>CDP: Enable Accessibility domain
    getAccessibilityTree->>CDP: Accessibility.getFullAXTree
    CDP-->>getAccessibilityTree: AXNode[]
    getAccessibilityTree->>getAccessibilityTree: Build hierarchical tree
    getAccessibilityTree-->>User: TreeResult

Loading

[greptile-apps]

_{2 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}