codespar Python SDK v0.1.0

First release of the CodeSpar Python SDK.

Same surface as `@codespar/sdk` — same backend, same payloads, same preset names.

Install

```bash
pip install codespar
```

Requires Python 3.10+.

Quick start

```python
from codespar import CodeSpar

cs = CodeSpar(api_key="csk_live_...")
session = cs.create("user_123", preset="brazilian")
print(session.send("Charge R$500 via Pix").message)
session.close()
cs.close()
```

What's included

• `CodeSpar` (sync) + `AsyncCodeSpar` (async) — both canonical, same API.
• `Session.send` / `send_stream` — blocking or streaming agent loop.
• `Session.execute` — call a specific tool by name.
• `Session.proxy_execute` — raw HTTP proxy to any connected server with server-side credential injection.
• `Session.authorize` — Connect Link OAuth flow for provider auth.
• Typed `StreamEvent` dataclasses (`UserMessageEvent`, `AssistantTextEvent`, `ToolUseEvent`, `ToolResultEvent`, `DoneEvent`, `ErrorEvent`).
• Presets: `brazilian`, `mexican`, `argentinian`, `colombian`, `all`.
• Per-project scoping: pass `project_id="prj_..."` on client or per session; defaults to the org's default project when omitted.
• `ApiError` / `ConfigError` / `StreamError` wrap every transport / protocol failure.

Publishing via trusted publishing

This release publishes to PyPI automatically via GitHub's OIDC flow — no long-lived API tokens in repo secrets.

Package source: packages/python/