[seanmcguire12]

why

• to give users a stable contract for getting the extension archive, instead of reaching into the internals of stagehand & relying on brittle file paths that may change across releases

what changed

added an extension archive getter in all three SDKs:

• TypeScript: await getExtensionArchive() → Uint8Array
• Python: get_extension_archive() → bytes
• Go: ExtensionArchive() → []byte

test plan

• added tests covering archive contents, extraction, repeatability, and independent buffer

---

Summary by cubic

Adds a public getter for the bundled Stagehand extension archive across all three SDKs, so users no longer need to reach into internal file paths.

• TypeScript: getExtensionArchive() returns a Uint8Array; Python: get_extension_archive() returns bytes; Go: ExtensionArchive() returns []byte.
• Tests verify the archive is a valid ZIP, extractable, repeatable, and that mutating a returned copy doesn't corrupt later calls.

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

[changeset-bot]

🦋 Changeset detected

Latest commit: 6769580

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

This PR includes changesets to release 23 packages

Name	Type
@browserbasehq/stagehand-python	Minor
@browserbasehq/stagehand-go	Minor
@browserbasehq/stagehand	Minor
browse	Patch
@browserbasehq/stagehand-examples	Patch
@browserbasehq/stagehand-integrations-claude-cua-sdk	Patch
@browserbasehq/stagehand-integrations	Patch
@browserbasehq/eve	Patch
@browserbasehq/stagehand-integrations-gemini-cua-sdk	Patch
@browserbasehq/stagehand-integrations-example-pi-facade	Patch
@browserbasehq/stagehand-integrations-claude-agent-sdk	Patch
@browserbasehq/stagehand-integrations-example-claude-code-facade	Patch
@browserbasehq/stagehand-integrations-codex-sdk	Patch
@browserbasehq/stagehand-integrations-example-codex-facade	Patch
@browserbasehq/stagehand-integrations-cursor-sdk	Patch
@browserbasehq/stagehand-integrations-example-cursor-facade	Patch
@browserbasehq/stagehand-integrations-deepagents-sdk	Patch
@browserbasehq/stagehand-integrations-eve-sdk	Patch
@browserbasehq/stagehand-integrations-fx-sdk	Patch
@browserbasehq/stagehand-integrations-mastra-sdk	Patch
@browserbasehq/stagehand-integrations-example-mastra-facade	Patch
@browserbasehq/stagehand-integrations-pi-sdk	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 10 files

Architecture diagram

sequenceDiagram
    participant TS as TypeScript SDK
    participant Py as Python SDK
    participant Go as Go SDK
    participant Assets as Extension Assets Module
    participant FS as File System
    participant Zip as ZIP Archive

    Note over TS,Go: Public API for extension archive retrieval

    TS->>TS: getExtensionArchive()
    TS->>FS: readFile(STAGEHAND_EXTENSION_ARCHIVE_PATH)
    FS-->>TS: Buffer (ZIP bytes)
    TS-->>TS: Return Buffer

    Py->>Py: get_extension_archive()
    Py->>Assets: build_extension_archive()
    Assets->>FS: Read extension source files
    FS-->>Assets: File contents
    Assets->>Zip: Create in-memory ZIP
    Zip-->>Assets: ZIP bytes
    Assets-->>Py: bytes
    Py-->>Py: Return bytes

    Go->>Go: ExtensionArchive()
    Go->>Assets: extensionassets.Archive()
    Assets->>Assets: Return copy of embedded archive
    Assets-->>Go: []byte (ZIP)
    Go-->>Go: Return []byte

    Note over TS,Go: Consumers can save, upload, or extract to dir

Loading

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

View guided diff | Turn on auto-fix | Re-trigger cubic</sub>

[miguelg719]

nit: TS and Go return the prebuilt stagehand-extension.zip, but Python re-zips _extension/ on every call. The extracted contents should match, but the zip bytes and hashes won't match across SDKs, so anyone checksumming or deduping uploads by hash will be surprised. Could the Python package ship the same prebuilt zip and have this read it, the same way TS reads dist/assets/stagehand-extension.zip? That would also skip rebuilding the archive on each call.