Skip to content

Python SDK 0.3.0

Choose a tag to compare

@fabianocruz fabianocruz released this 30 Apr 00:22

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:

  • projectId on CodeSparConfig and SessionConfig (2-level Org → Project tenancy threading via x-codespar-project)
  • session.authorize(server_id, config) — managed-auth flow (api_key, path_secret, OAuth) returns the connection state without leaving the session loop
  • session.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.0

Publishing

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.