SDK overview - BMA Developer Docs

Most apps need no BMA package: BMA serves the Anthropic Managed Agents API under /v1, so the official Anthropic SDKs (Python, TypeScript) work with base_url pointed at BMA. Use bma-executor-sdk only when you connect your own machine (hands) or your own agent (brain) to BMA.

	Anthropic SDKs	bma-executor-sdk
You are	An app that runs agents	A machine (hand) or an agent loop (brain) that BMA drives
Talks to	The `/v1` API: Managed Agents routes and the BMA extensions	Executor Protocol `bma.executor.v1.1` (JSON-RPC 2.0 over WebSocket)
Responsibilities	Agents, environments, sessions, events and SSE, files, memory stores; the BMA extensions (machines, pools, desktop and terminal sessions and tickets, vaults, skills) through the generic request methods	Executor end (register, heartbeat, reconnect, tool calls, processes, MCP channel, artifact upload), harness end (drive executors), agent capability (both sides)
Credential	Organization API key (`x-api-key`)	Environment key or machine token, exchanged for a 5-minute JWT
Languages	Python, TypeScript	Go (reference), TypeScript, Python
Status	Available: see Anthropic SDKs	Available. The platform side of the agent capability accepts text input only.

Packages and versions

Each SDK repository releases all three languages from one tag. Versions as published on 2026-11-09:

SDK	Language	Package	Version	Runtime
bma-sdk	Go	`github.com/beeos-ai/bma-sdk/v2` (package `bmasdk`)	v2.1.0	Go 1.25+
bma-sdk	TypeScript	`@beeos-ai/bma-sdk`	2.1.0	Node.js 20+, ESM
bma-sdk	Python	`bma-sdk` (`bma_sdk`)	2.1.0	Python 3.10+
bma-executor-sdk	Go	`github.com/beeos-ai/bma-executor-sdk` (package `bmaexecutor`)	v1.3.0	Go 1.25+
bma-executor-sdk	TypeScript	`@beeos-ai/bma-executor-sdk`	1.3.0	Node.js 20+, ESM
bma-executor-sdk	Python	`bma-executor-sdk` (`bma_executor_sdk`)	1.3.0	Python 3.10+

bma-executor-sdk is Apache-2.0, generated from machine-readable contracts checked into the repository (contracts/bma/), and tested in all three languages against the same conformance examples.

Which one do I need?

Language parity

Capability	Go	TypeScript	Python
executor: executor end	✅	✅	✅ (asyncio)
executor: execution `Core` (bash, file tools, stdio MCP)	✅	—	—
executor: `process.*` / `skill.install` helpers	✅	— (`onRequest`)	— (`on_request`)
executor: harness end	✅	✅	✅
executor: agent capability (both sides)	✅	✅	✅
executor: executor listens on a local socket	✅	✅	—

Anthropic SDKs

Connect the official SDKs and call the /v1 extensions

bma-executor-sdk

Connect your machine (hands) or your own agent (brain) to BMA