Repository navigation
Releases
codespar (Python) 0.16.2
Statement as PNG pages: account.statement(format='png', page=N) with the page count. Supersedes 0.16.1, which was never published.
codespar (Python) 0.16.0
Payables v1.1: uma conta, duas vias. Itens de lote passam a ter vias Pix e boleto e a troca de via (set_rail).
codespar (Python) 0.15.1
Documentos: comprovante PDF/PNG (receipt_document) e extrato PDF (statement_document). Correção de lint do pacote; 0.15.0 não foi publicada.
codespar (Python) 0.15.0
Documentos: comprovante PDF/PNG (receipt_document) e extrato PDF (statement_document).
codespar (Python) 0.14.0
Pix keys from the SDK: cs.wallet.pix_keys list/register/delete with the confirm guard. Matches @codespar/sdk 0.16.21 (core #223).
codespar (Python) 0.13.0
Pay documents and batches: payables files, batches, confirm and pay in the Python SDK. Matches @codespar/sdk 0.16.19 (core #219).
codespar (Python) 0.11.0
Offline V3 mandate verification: new codespar.mandate submodule (decode + canonical reconstruction pure-stdlib; Ed25519 verify via the [verify] extra). Parity with @codespar/sdk/mandate and codespar mandate verify; canonical signing string byte-locked across all four implementations. See codespar-core#114 / #115.
codespar 0.10.0 (Python SDK)
What's Changed
- docs: Sprint 2A — SDK READMEs drift cleanup (8 files) by @fabianocruz in #19
- chore(adapters): bump 12 framework adapters to 0.4.0 + peerDeps ^0.9.0 by @fabianocruz in #20
- feat(cli): 0.4.0 — sugar commands for SDK 0.9.0 typed methods by @fabianocruz in #21
- feat(api-types): 0.5.0 — add jwt_ecdsa to AuthTypeSchema by @fabianocruz in #22
- fix(deps): unbreak @codespar/sdk:typecheck — @codespar/types range in core + lock drift guard by @dangazineu in #26
- feat(sdk): @codespar/sdk/testing fakeSession export by @dangazineu in #23
- feat(examples): Pix + NFS-e walking skeleton — 4-step loop() against OSS MCP bridge by @dangazineu in #30
- feat(examples): service invoice from natural language (NFS-e + WhatsApp + aimock) by @dangazineu in #32
- feat(examples): WhatsApp installment negotiation (multi-turn session.send + Asaas preview) by @dangazineu in #34
- refactor(examples/pix-nfse-skeleton): raise bar to match installment-negotiation example by @dangazineu in #41
- refactor(examples/nfse-from-natural-language): raise bar to match installment-negotiation example by @dangazineu in #40
- chore: replace private roadmap codenames in public READMEs by @dangazineu in #55
- feat(sdk): hosted test-mode SDK surface — mocks forwarding, structured errors, tool-result guards, OSS test-parity seam by @dangazineu in #54
- chore(release): bump @codespar/types, @codespar/sdk, codespar to 0.10.0 by @dangazineu in #56
- fix(publish): surface real npm failures + tolerate propagation lag by @fabianocruz in #57
- fix(example/brazilian-ecommerce): pass declared_value on codespar_ship items by @fabianocruz in #59
- fix(example/brazilian-ecommerce): pass length_cm/width_cm/height_cm on ship items by @fabianocruz in #60
- ci(publish): relax whoami identity check + tighten 404-PUT lag heuristic by @dangazineu in #61
- ci(publish): drop per-package access preflight (incompatible with granular tokens) by @dangazineu in #62
- fix(publish): fail loud on multi-package 404-PUT, bump to Node 22 by @dangazineu in #63
- feat(publish): add OIDC trusted-publishing path via workflow_dispatch by @dangazineu in #64
- feat(publish): migrate tag-push path to OIDC trusted publishing by @dangazineu in #65
Full Changelog: python-v0.9.0...python-v0.10.0
codespar 0.9.0
codespar 0.9.0
SSE streaming for async settlement + verification status.
Added
AsyncSession.payment_status_stream(tool_call_id, *, on_update=None)— SSE stream overGET /v1/tool-calls/:id/payment-status/stream. Pushes initial snapshot + every state change; returns last envelope on terminal state (5s grace).AsyncSession.verification_status_stream(tool_call_id, *, on_update=None)— KYC sibling with the same lifecycle.- Sync wrappers:
Session.payment_status_stream/Session.verification_status_stream. _http.stream_sse_get(...)— GET-based SSE iterator yielding(event_name, payload)tuples; filters heartbeat comment frames.
Compat
- Polling siblings (
payment_status/verification_status) stay live for backward compat. - User-Agent bumped to
codespar-python/0.9.0.
TS paridade
@codespar/sdk@0.9.0+@codespar/types@0.7.0published in lockstep.
Python SDK 0.3.0
First Python SDK release on the 0.3.x line — aligns with @codespar/sdk@0.3.0 (npm).
What's in 0.3.0
The features that justify the version jump from 0.1.1 already shipped to main between 2026-04-21 and today; this release tags them on PyPI:
projectIdonCodeSparConfigandSessionConfig(2-level Org → Project tenancy threading viax-codespar-project)session.authorize(server_id, config)— managed-auth flow (api_key, path_secret, OAuth) returns the connection state without leaving the session loopsession.proxy_execute(request)— raw HTTP proxy through the Tool Router for tools the agent needs to call directly without an MCP shape
Skipping 0.2.x intentionally — keeps Python and JS on the same major-line so the matrix stays simple:
| Package | Version |
|---|---|
@codespar/sdk (npm) |
0.3.0 |
codespar (PyPI) |
0.3.0 |
@codespar/cli |
0.3.0 |
| Framework adapters | 0.3.0 |
@codespar/types |
0.1.0 |
@codespar/api-types |
0.2.0 |
Install
pip install codespar==0.3.0Publishing
PyPI upload via OIDC trusted publishing — no long-lived API tokens. The publish-python.yml workflow runs lint (ruff) + type check (mypy strict) + pytest + build + twine check + upload on this release event.