feat(sdk): export StagehandLog from public entrypoints

[HaoChiBao]

Summary

• Export StagehandLog from the public TypeScript and Python SDK entrypoints.
• Update logging docs to import the type from the public package and drop the related TODO.
• Add a patch Changeset for both SDKs.

Test plan

• TypeScript: import type { StagehandLog } from @browserbasehq/stagehand resolves
• Python: from stagehand import StagehandLog resolves and is listed in __all__
• Logging docs examples compile / match the public API

---

Summary by cubic

Export StagehandLog from the public TypeScript and Python SDK entry points, and export StagehandLogLevel and StagehandLogData in Python so apps can import from the package root. Previously these types were not re-exported; there are no runtime changes.

Migration

• TypeScript: import type { StagehandLog } from '@browserbasehq/stagehand'.
• Python: from stagehand import StagehandLog, StagehandLogLevel, StagehandLogData.

^{Written for commit 8c55dff. Summary will update on new commits.}

[changeset-bot]

🦋 Changeset detected

Latest commit: 8c55dff

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

This PR includes changesets to release 6 packages

Name	Type
@browserbasehq/stagehand	Patch
@browserbasehq/stagehand-python	Patch
@browserbasehq/stagehand-integrations	Patch
@browserbasehq/stagehand-integrations-example-eve-facade	Patch
@browserbasehq/stagehand-integrations-example-mastra-facade	Patch
@browserbasehq/stagehand-integrations-example-vercel-ai-facade	Patch

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]

All reported issues were addressed across 4 files

Architecture diagram

sequenceDiagram
    participant App as External Application
    participant SDK as Stagehand SDK
    participant TypeDefs as Type Definitions
    participant PkgExports as Public Exports
    participant Logger as Logging Callback

    Note over App,Logger: TypeScript SDK Public API Export Flow

    App->>App: Source file imports StagehandLog<br>from package root

    alt TypeScript
        App->>PkgExports: import type { StagehandLog }<br>from "@browserbasehq/stagehand"
        PkgExports->>TypeDefs: Resolve to sdk-ts/src/index.ts
        TypeDefs-->>PkgExports: Export StagehandLog type
        PkgExports-->>App: Type available at runtime compile time
    else Python
        App->>PkgExports: from stagehand import StagehandLog
        PkgExports->>PkgExports: Check __init__.py exports
        PkgExports-->>App: StagehandLog in __all__
    end

    App->>Logger: Register logging callback
    Logger->>SDK: Initialize Stagehand client
    SDK->>Logger: Execute Stagehand operations
    Logger->>Logger: Accept log parameter typed as StagehandLog
    Logger-->>App: Structured log output

Loading

<sub>Tip: cubic used a learning from your PR history. Let your coding agent read cubic learnings directly with the cubic MCP.

Re-trigger cubic</sub>