Skip to content

[Feature]: Keep adapter API stable; add recon-to-adapter translation hints #226

Description

@beubax

Feature Description

Browser recon now uses a Playwright-style contract, while reusable adapters still use Webcmd’s existing IPage/adapter APIs. We should preserve that boundary and avoid introducing a second adapter contract.

Proposal:

  • Keep browser run as exploratory/ad-hoc Playwright-style code.
  • Keep adapters on the existing stable API: browser:false -> func(args), browser:true -> func(page,args).
  • Add structured adapterHints to recon/analyze output with:
    • recommended strategy
    • selector evidence
    • network evidence
    • state hazards
    • adapter-compatible path
    • explicit “do not copy Playwright code into adapter” guidance
  • Only extend IPage with narrow primitives when evals prove a missing capability.

Reason:
Letting adapters accept both Playwright-style page and IPage would increase cloud/local parity risk, repair cost, and agent confusion. A translation artifact gives agents the bridge without changing the adapter API.

Use Case

For users creating new adapters, it must get made efficiently.

Proposed Solution

No response

Alternatives Considered

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions