Pre-release

This release is a pre-release and may not be stable for production use.

band-sdk-core-py

Python package for band-sdk-core-core (import band_sdk_core).

Public surface

EventType is the closed set of inbound event names.

validate_event_payload(event_type, raw, trace_context=None): event_type is a platform name ("message_created", "agent.control", …) or an EventType. raw is a JSON-shaped Python value. Success returns the normalized payload (event_created returns the input unchanged). Failure raises ValueError with .args == (message,) (str(e) is ordinary), .issues (a tuple of (path, code, message)), and .trace_context. There is no custom exception class.

ClaimRegistry, RetryTracker, ParticipantRoster are the inbound-delivery runtime state classes -- lifecycle and design decisions: ../core/docs/runtime-state-policy.md. A participant is any mapping; add/set_all read id, name, type, handle, description from it and list() returns dicts with exactly those five keys. id is required and must be a string; the other four are each a string or None. A non-mapping value, a missing/non-string id, or another field that is not a string or None raises TypeError. set_all takes an optional trace_context and raises ValueError -- leaving the roster unchanged, with .issues and .trace_context attached like validate_event_payload's error -- if its snapshot names the same id twice. RetryTracker's max_tracked must be at least 1; 0 raises ValueError. ClaimRegistry's max_completed must be at least 1 too -- 0 also raises ValueError.

MemorySystem, MemoryType, MemorySegment, MemoryStoreScope, MemoryListScope, MemoryStatus are the canonical memory taxonomy -- design decisions: ../core/docs/memory-taxonomy-policy.md. Each is a closed set with a wire_name property and a from_wire_name static method (None for an unrecognized string), mirroring EventType.

validate_memory_type_for_system(system, memory_type, trace_context=None): system/memory_type are each a wire-name string or the matching MemorySystem/MemoryType instance (mirroring validate_event_payload's acceptance of either an event name or an EventType), and it returns None on success. Failure raises ValueError with the same .issues/.trace_context contract as validate_event_payload -- an unrecognized system and an unrecognized memory_type are independent issues, both reported when both strings are invalid.

Values across the language boundary

JSON objects become Python dicts. JSON null becomes None. An explicit null stays distinct from an absent key — a distinction the payload validator uses. Values that cannot be converted raise TypeError, which except Exception catches.

Build / test

just check type-checks and lints this crate. Linking the extension happens through uv / maturin (just test-py, just build-py), not cargo test.

just test-py     # uv sync, pytest, isolated wheel install
just build-py    # uv build (wheel only)

Wheels are platform-specific. Recipes use uv and honor UV_PYTHON, or PYTHON / PYTHON_BIN. Windows builds need the MSVC toolchain rustup's default host target uses.

The wheel is abi3 for Python >= 3.11. Typed stubs are band_sdk_core.pyi plus an empty py.typed. just test-py checks they match the runtime package and that they ship in the wheel.

Project links

Data verified by PyPI on Aug 21, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.4.0)

Owner

PyPI data
Data sourced directly from PyPI's database.

Credits

Author: band.ai

GitHub Statistics

Data verified by PyPI on Aug 21, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.11

Tags

band sdk validation events

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

band_sdk_core-0.4.0.dev2-cp311-abi3-win_arm64.whl (242.1 kB view details)

Uploaded CPython 3.11+Windows ARM64

band_sdk_core-0.4.0.dev2-cp311-abi3-win_amd64.whl (252.1 kB view details)

Uploaded CPython 3.11+Windows x86-64

band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_x86_64.whl (624.2 kB view details)

Uploaded CPython 3.11+musllinux: musl 1.2+ x86-64

band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_aarch64.whl (589.7 kB view details)

Uploaded CPython 3.11+musllinux: musl 1.2+ ARM64

band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_x86_64.whl (418.6 kB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ x86-64

band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_aarch64.whl (412.1 kB view details)

Uploaded CPython 3.11+manylinux: glibc 2.28+ ARM64

band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_11_0_arm64.whl (370.2 kB view details)

Uploaded CPython 3.11+macOS 11.0+ ARM64

band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_10_12_x86_64.whl (371.4 kB view details)

Uploaded CPython 3.11+macOS 10.12+ x86-64

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-win_arm64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-win_arm64.whl
Algorithm Hash digest
SHA256 244b57e1d3529b30000797ff111a18728a6177ccbe7e755c220cce936b3cd43b
MD5 faa1b29003860affe95db9c7a1f3caf0
BLAKE2b-256 6ab3c8b09f193daf9784a380af99877bf2c0b5d39e65bae10049f78f8cbe4b40

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-win_arm64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 2da7cbf1ca2090833346ff92347f9c7d59650cec69361c77181ef84058e560d3
MD5 f799d89631044f23cca2e94e7b378a08
BLAKE2b-256 c522be0cb60812202208d7989bebd94c1d08d5c7d5aae5ad61dd51477abcc372

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-win_amd64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 06dc1a96e1900ac1e3e92e1b1423e2d2c90299ad3b8ffd227cc31655fd329d0a
MD5 7e0d0352216a696b154fcf90539c17fc
BLAKE2b-256 04b5af3d480e5fe3aa0b39e1910b247c4238d505aea97414b411e51bba0d2d5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_x86_64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 0444e984e7cd2c8b5ff15df8063de33cc37478c455ebf7977eb2a5ef2081c6d5
MD5 4cad49c4549e7a699138531fb715b0c5
BLAKE2b-256 49a430c463e297c1d797b42e626e3f3b4cd48311ad07c9f0ba7ddd41155e70bc

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-musllinux_1_2_aarch64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 9d5c00db656cbfe34366d1e173a7c0f82d337850549ed60d0d008031b71cf40d
MD5 72694d358e22cb74d41b122e294be854
BLAKE2b-256 c9137bc28dda850d586da4c670cea59fb2a8ee1d47af565d885269398e8c11be

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_x86_64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 94233e5a936c9c8ed9cf7bb36df7bfeb4e5b10be1284c42795c446209a3bac59
MD5 a5346a175b19299724378f6459e56b22
BLAKE2b-256 78d7aac81613c2a723db243c7e39740d7618cbcd656d324fd717073de12a9080

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-manylinux_2_28_aarch64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5032ec52e6fa181a975c77ffce460048d50de48d83bf6c0cd913903e6fe40c72
MD5 fd2293460b37fea3745e0c9686c83b66
BLAKE2b-256 3bbcb5f4da4d643235eaba3c8c7c1b74b8d0017bbe4ce282295d9f22b2a96486

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_11_0_arm64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 6b2b3baeb79101e04c58c8e11113aade5d8a3cc17ab612b60cb76f447ea24d38
MD5 061cf1ffb20ad84f34f925161e73144f
BLAKE2b-256 1f20452e188c7bff2518a6dcda2cbb2b0599ac3fc560cbcdccae9fcab244376a

See more details on using hashes here.

Provenance

The following attestation bundles were made for band_sdk_core-0.4.0.dev2-cp311-abi3-macosx_10_12_x86_64.whl:

Publisher: publish.yml on band-ai/band-sdk-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.4.0

8 files

2.3.0

8 files

2.2.0

8 files

2.1.0

8 files

2.0.0

8 files

1.2.1

8 files

1.2.0

8 files

1.1.0

8 files

1.0.1

8 files

1.0.0

8 files

0.8.0

8 files

0.7.2

8 files

0.7.1

8 files

0.7.0

8 files

0.6.0

8 files

0.5.0

8 files

0.4.1

8 files

0.4.0

8 files

This release
Pre-release

0.4.0.dev2 This release

8 files

Pre-release

0.4.0.dev1

8 files

Pre-release

0.4.0.dev0

8 files

Pre-release

0.2.1.dev4

6 files

Pre-release

0.2.1.dev2

6 files

Pre-release

0.2.1.dev1

6 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page