codespar 0.1.0__py3-none-any.whl

codespar-0.1.0.dist-info/METADATA

@@ -0,0 +1,187 @@
+Metadata-Version: 2.4
+Name: codespar
+Version: 0.1.0
+Summary: Python SDK for CodeSpar — commerce infrastructure for AI agents in Latin America.
+Project-URL: Homepage, https://codespar.dev
+Project-URL: Documentation, https://docs.codespar.dev
+Project-URL: Repository, https://github.com/codespar/codespar
+Project-URL: Issues, https://github.com/codespar/codespar/issues
+Author-email: CodeSpar <hello@codespar.dev>
+License: MIT
+Keywords: agents,ai,commerce,latam,mcp,nfe,pix,stripe
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# codespar — Python SDK
+
+Commerce infrastructure for AI agents in Latin America. Pix, NF-e,
+WhatsApp, shipping, banking — one API, no provider-key boilerplate.
+
+[![PyPI](https://img.shields.io/pypi/v/codespar.svg)](https://pypi.org/project/codespar/)
+[![Python versions](https://img.shields.io/pypi/pyversions/codespar.svg)](https://pypi.org/project/codespar/)
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/codespar/codespar/blob/main/LICENSE)
+
+## Install
+
+```bash
+pip install codespar
+```
+
+Python 3.10+ required.
+
+## Quick start
+
+```python
+from codespar import CodeSpar
+
+cs = CodeSpar(api_key="csk_live_...")
+
+session = cs.create(
+    "user_123",
+    preset="brazilian",   # zoop, nuvem-fiscal, melhor-envio, z-api, omie
+    # project_id="prj_...", # optional — defaults to the org's default project
+)
+
+result = session.send(
+    "Charge R$500 via Pix to +5511999887766 and send the QR code by WhatsApp."
+)
+print(result.message)
+for call in result.tool_calls:
+    print(f"  → {call.tool_name} ({call.duration_ms}ms)")
+
+session.close()
+cs.close()
+```
+
+Or as a context manager:
+
+```python
+with CodeSpar(api_key="csk_live_...") as cs:
+    session = cs.create("user_123", preset="brazilian")
+    print(session.send("Quero pagar R$125 via Pix").message)
+```
+
+## Streaming
+
+```python
+for event in session.send_stream("Process order #BR-7721"):
+    if event.type == "assistant_text":
+        print(event.content, end="", flush=True)
+    elif event.type == "tool_use":
+        print(f"\n→ calling {event.name}...")
+    elif event.type == "tool_result":
+        print(f"  {event.tool_call.status} in {event.tool_call.duration_ms}ms")
+```
+
+## Async
+
+```python
+import asyncio
+from codespar import AsyncCodeSpar
+
+async def main():
+    async with AsyncCodeSpar(api_key="csk_live_...") as cs:
+        session = await cs.create("user_123", preset="brazilian")
+        result = await session.send("charge R$500 via Pix")
+        print(result.message)
+        await session.close()
+
+asyncio.run(main())
+```
+
+## Multi-environment (projects)
+
+CodeSpar scopes every session to an environment (`prj_<id>`). Pass a
+project id on the client for the whole lifetime, or per-session when
+you want to target a different environment:
+
+```python
+# Pin every session this client spawns to the staging project
+cs = CodeSpar(api_key="csk_live_...", project_id="prj_staging0123abcd")
+
+# Override per session
+session = cs.create("user_123", preset="brazilian", project_id="prj_prod0123abcd")
+```
+
+When you omit `project_id`, CodeSpar routes to the org's **default
+project** — always defined, self-healed on first read.
+
+## Raw HTTP proxy
+
+Skip the agent loop and hit a provider API directly through CodeSpar's
+credential vault:
+
+```python
+from codespar import ProxyRequest
+
+response = session.proxy_execute(ProxyRequest(
+    server="stripe-acp",
+    endpoint="/v1/charges",
+    method="POST",
+    body={"amount": 2000, "currency": "brl"},
+))
+print(response.status, response.data)
+```
+
+No API key leaves your machine — CodeSpar injects it server-side.
+
+## Connect Links (OAuth)
+
+```python
+from codespar import AuthConfig
+
+link = session.authorize(
+    "stripe-acp",
+    AuthConfig(redirect_uri="https://your.app/connected"),
+)
+print(f"Open this URL to connect Stripe: {link.authorize_url}")
+```
+
+After the user completes the OAuth flow, CodeSpar stores the tokens in
+the per-project vault and forwards them back to `redirect_uri` with
+`?status=connected&connection_id=<id>` appended.
+
+## Errors
+
+Every failure is wrapped:
+
+```python
+from codespar import ApiError, ConfigError, StreamError
+
+try:
+    session = cs.create("user_123", preset="brazilian")
+except ConfigError as exc:
+    print(f"Bad config: {exc}")
+except ApiError as exc:
+    print(f"Backend said {exc.status}: {exc.code}")
+```
+
+## Design parity with the JS SDK
+
+This package mirrors [`@codespar/sdk`](https://www.npmjs.com/package/@codespar/sdk)
+method-for-method. Same backend, same payloads, same preset names — pick
+the language that fits your stack without giving anything up.
+
+## Links
+
+- [Documentation](https://docs.codespar.dev)
+- [Dashboard](https://dashboard.codespar.dev)
+- [JS SDK (npm)](https://www.npmjs.com/package/@codespar/sdk)
+- [Report a bug](https://github.com/codespar/codespar/issues)

codespar-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+codespar/__init__.py,sha256=6vvuAQWnGMA79an6cQjNdI8Ze0UpQUbLQMYYMT93mdA,2260
+codespar/_async_client.py,sha256=a3vNjn0FnXe1jC4ukIu560kHsq62EWc254knmRi_S0c,5705
+codespar/_async_session.py,sha256=yZss19IwQyZ4PXH248JHO3RLoUOtyOjtpfKcZ0YADHA,15158
+codespar/_http.py,sha256=vl3qTOd7xmJ-g7bRrQAnSWFzB2soJY8GUy8ppRSp_ic,4615
+codespar/_presets.py,sha256=7H-rEi35YP3yHFCtFtn0ansW46B7BoUky8TV4i_aA40,1239
+codespar/_sync_client.py,sha256=D9UjETCfzwVIJ7j3awf4of_mcQmOsP4Q7YoRlwYwLyM,7006
+codespar/errors.py,sha256=rUgDCIWlnAtF_TtZkjc7YVta87RGwOagVestvbycaV8,1307
+codespar/types.py,sha256=kx0-CBOBRYY80NV1WCXd17mkSl-WJnO5JlswaW5ZjPI,4812
+codespar-0.1.0.dist-info/METADATA,sha256=IOAKy0QW8rkVuYYPNMOjjwT4bhzSoOqVUPtC5-7Gp-I,5627
+codespar-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+codespar-0.1.0.dist-info/RECORD,,

codespar-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any