docs(integrations): rewrite codemode integration guides

[shrey150]

Summary

• replace the stale integration overview with a practical guide to the shared run, snapshot, and screenshot Code Mode tools
• add runnable quickstarts for CrewAI, Deep Agents, Eve, Mastra, and the Vercel AI SDK
• document framework-specific configuration, persistent browser-session requirements, screenshot behavior, and the browser security boundary
• clarify that MCP child processes require an explicit STAGEHAND_MODEL_API_KEY, while the in-process Eve integration can infer supported provider credentials

Why

The integrations under packages/integrations had landed, but their READMEs still described earlier scaffolding and internal facade terminology. Developers needed one consistent path for choosing an adapter, building it from source, configuring the agent and browser models separately, and understanding the session/security constraints.

Impact

Developers can now follow framework-specific commands and use one documented tool contract across all five integrations. The guides make credential ownership explicit: agent-model keys stay in the host process, and MCP children receive only Stagehand and Browserbase configuration.

E2E Test Matrix

Command / flow	Observed output	Confidence / sufficiency
Fresh clone, corepack pnpm@11.10.0 install, and filtered integration build	Install completed with pnpm 11.10.0; Turbo reported 4/4 build tasks successful.	Proves the documented monorepo setup from a fresh checkout.
turbo run typecheck test:unit --filter @browserbasehq/stagehand-integrations	6/6 tasks passed; 18/18 core tests passed.	Covers the shared tool contract, stdio lifecycle, server behavior, and TypeScript types.
CrewAI locked sync and contract tests	Locked sync completed under Python 3.11; 3/3 tests passed.	Verifies the documented Python environment and MCP adapter contract. The exact agent CLI reached the real model call but the configured provider account returned exhausted quota before a tool call.
Deep Agents locked sync + real Browserbase agent	Both locked sync commands completed; after selecting an available provider through the documented model-edit step, the real agent initialized Stagehand, browsed public pages, and returned structured results.	Proves the local Deep Agents model loop and Browserbase tool path. The checked-in OpenAI default was blocked by exhausted provider quota.
Eve dev, tests, and typecheck	Eve v0.29.4 built and reached Ready; 5/5 tests and TypeScript passed.	Proves the documented startup and native contract. The supplemental interactive task was blocked at the model call by exhausted provider quota before creating a browser.
Mastra MCP client + real Browserbase run	Tool discovery succeeded; navigation to a public synthetic page returned Example Domain; the client disconnected and the browser completed.	Proves Mastra transport, browser launch, tool execution, and cleanup. The exact model-driven CLI was blocked before tool use by exhausted provider quota.
Vercel AI SDK MCP client + real Browserbase run	Tool discovery succeeded; navigation to a public synthetic page returned Example Domain; the client closed and the browser completed.	Proves AI SDK transport, browser launch, tool execution, and cleanup. The exact model-driven CLI was blocked before tool use by exhausted provider quota.
Framework unit/typecheck matrix	Deep Agents 7/7, Eve 5/5, Mastra 2/2, and Vercel AI SDK 2/2 tests passed; all TypeScript checks passed.	Provides regression coverage for every documented adapter.

The previously included lockfile repair was removed because #2684 already merged that fix into main.

[changeset-bot]

⚠️ No Changeset found

Latest commit: 5d5be70

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

[cubic-dev-ai]

No issues found across 2 files

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

Architecture diagram

sequenceDiagram
    participant CI as CI Pipeline
    participant Pnpm as pnpm 11.10.0
    participant Catalog as pnpm Catalog
    participant EvePkg as Eve Package (packages/integrations/eve)
    participant Lockfile as pnpm-lock.yaml
    participant TypeCheck as turbo typecheck

    Note over CI,TypeCheck: Workspace lockfile repair flow

    CI->>Pnpm: corepack pnpm@11.10.0 install --frozen-lockfile
    Pnpm->>Catalog: read catalog entries from pnpm-workspace.yaml
    Catalog-->>Pnpm: catalog includes eve: 0.29.4
    Pnpm->>EvePkg: resolve eve dependency from catalog
    EvePkg-->>Pnpm: package.json references eve: catalog:
    Pnpm->>Lockfile: verify lockfile matches catalog + dependencies
    alt Lockfile valid and complete
        Lockfile-->>Pnpm: supply-chain policy OK, "Already up to date"
        Pnpm-->>CI: install success
    end

    CI->>TypeCheck: turbo run typecheck --filter='./packages/integrations/*'
    TypeCheck->>EvePkg: typecheck Eve workspace
    EvePkg-->>TypeCheck: TypeScript exit code 0
    TypeCheck-->>CI: 7/7 tasks passed

    Note over Pnpm,Lockfile: Lockfile includes Eve importer and transitive snapshots
    Pnpm->>Lockfile: regenerate with pnpm 11.10.0
    Lockfile-->>Pnpm: complete dependency graph for Eve

Loading

_{Re-trigger cubic}

[cubic-dev-ai]

All reported issues were addressed across 6 files (changes from recent commits).

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[Kylejeong2]

lgtm, other than the project id stuff