codespar 0.3.0__tar.gz → 0.9.0__tar.gz

codespar-0.9.0/CHANGELOG.md

@@ -0,0 +1,26 @@
+# codespar (Python SDK) — CHANGELOG
+
+## 0.9.0
+
+- New: `AsyncSession.payment_status_stream(tool_call_id, *, on_update=None)`.
+  Opens an SSE stream against
+  `GET /v1/tool-calls/:id/payment-status/stream`, invokes `on_update`
+  (sync or async callable) for the initial snapshot + every state
+  change, and returns the last envelope observed once the backend
+  closes the stream (5s after terminal state). Cancel by wrapping
+  the awaitable in an `asyncio.Task` and calling `.cancel()`.
+- New: `AsyncSession.verification_status_stream(tool_call_id, *, on_update=None)`
+  — KYC sibling with the same lifecycle.
+- New: matching sync wrappers `Session.payment_status_stream` and
+  `Session.verification_status_stream` on the blocking client.
+- New: `_http.stream_sse_get(...)` helper, GET-based SSE iterator
+  yielding `(event_name, payload)` tuples and filtering heartbeat
+  comment frames. The existing `stream_sse` (POST-based) is kept for
+  the chat-loop's `send_stream`.
+- Polling siblings (`payment_status` / `verification_status`) stay
+  live for backward compat.
+- User-Agent bumped to `codespar-python/0.9.0`.
+
+## 0.8.0
+
+Previous release. See git log for prior entries.

{codespar-0.3.0 → codespar-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codespar
-Version: 0.3.0
+Version: 0.9.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
@@ -78,6 +78,48 @@ with CodeSpar(api_key="csk_live_...") as cs:
     print(session.send("Quero pagar R$125 via Pix").message)
 ```
 
+## Tool discovery + connection wizard
+
+Beyond `session.execute(tool, params)`, the SDK exposes typed wrappers
+for the F3.M2 meta-tools `codespar_discover` and
+`codespar_manage_connections`:
+
+```python
+from codespar import CodeSpar, ConnectionWizardOptions, DiscoverOptions
+
+with CodeSpar(api_key="csk_live_...") as cs:
+    session = cs.create("user_123", preset="brazilian")
+
+    # Find the right tool for a free-form use case.
+    found = session.discover(
+        "send a pix payment",
+        DiscoverOptions(country="BR", limit=3),
+    )
+    if found.recommended:
+        print(found.recommended.server_id, found.recommended.tool_name)
+        print(f"  status: {found.recommended.connection_status}")
+
+    # Surface the connection wizard if the recommended server isn't
+    # connected. NEVER pass credentials through this method —
+    # credentials only travel via the dashboard's connect modal or
+    # the OAuth callback. The wizard returns a deep-link the agent
+    # surfaces so the user finishes setup in their browser.
+    if found.recommended and found.recommended.connection_status == "disconnected":
+        wiz = session.connection_wizard(
+            ConnectionWizardOptions(
+                action="initiate",
+                server_id=found.recommended.server_id,
+            ),
+        )
+        if wiz.initiate:
+            print("Connect:", wiz.initiate.connect_url)
+            for line in wiz.initiate.instructions:
+                print(" ·", line)
+```
+
+Async users have the same surface on `AsyncSession`
+(`await session.discover(...)`, `await session.connection_wizard(...)`).
+
 ## Streaming
 
 ```python

{codespar-0.3.0 → codespar-0.9.0}/README.md

@@ -47,6 +47,48 @@ with CodeSpar(api_key="csk_live_...") as cs:
     print(session.send("Quero pagar R$125 via Pix").message)
 ```
 
+## Tool discovery + connection wizard
+
+Beyond `session.execute(tool, params)`, the SDK exposes typed wrappers
+for the F3.M2 meta-tools `codespar_discover` and
+`codespar_manage_connections`:
+
+```python
+from codespar import CodeSpar, ConnectionWizardOptions, DiscoverOptions
+
+with CodeSpar(api_key="csk_live_...") as cs:
+    session = cs.create("user_123", preset="brazilian")
+
+    # Find the right tool for a free-form use case.
+    found = session.discover(
+        "send a pix payment",
+        DiscoverOptions(country="BR", limit=3),
+    )
+    if found.recommended:
+        print(found.recommended.server_id, found.recommended.tool_name)
+        print(f"  status: {found.recommended.connection_status}")
+
+    # Surface the connection wizard if the recommended server isn't
+    # connected. NEVER pass credentials through this method —
+    # credentials only travel via the dashboard's connect modal or
+    # the OAuth callback. The wizard returns a deep-link the agent
+    # surfaces so the user finishes setup in their browser.
+    if found.recommended and found.recommended.connection_status == "disconnected":
+        wiz = session.connection_wizard(
+            ConnectionWizardOptions(
+                action="initiate",
+                server_id=found.recommended.server_id,
+            ),
+        )
+        if wiz.initiate:
+            print("Connect:", wiz.initiate.connect_url)
+            for line in wiz.initiate.instructions:
+                print(" ·", line)
+```
+
+Async users have the same surface on `AsyncSession`
+(`await session.discover(...)`, `await session.connection_wizard(...)`).
+
 ## Streaming
 
 ```python

{codespar-0.3.0 → codespar-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codespar"
-version = "0.3.0"
+version = "0.9.0"
 description = "Python SDK for CodeSpar — commerce infrastructure for AI agents in Latin America."
 readme = "README.md"
 requires-python = ">=3.10"

{codespar-0.3.0 → codespar-0.9.0}/src/codespar/__init__.py

@@ -40,18 +40,43 @@ from .types import (
     AssistantTextEvent,
     AuthConfig,
     AuthResult,
+    ChargeArgs,
+    ChargeBuyer,
+    ChargeMethod,
+    ChargeResult,
+    ConnectionDifficulty,
+    ConnectionStatus,
+    ConnectionStatusRow,
+    ConnectionWizardInstructions,
+    ConnectionWizardOptions,
+    ConnectionWizardResult,
+    DiscoverOptions,
+    DiscoverPlanStep,
+    DiscoverResult,
+    DiscoverToolMatch,
     DoneEvent,
     ErrorEvent,
     HttpMethod,
     ManageConnections,
+    PaymentStatus,
+    PaymentStatusEvent,
+    PaymentStatusResult,
     Preset,
     ProxyRequest,
     ProxyResult,
+    RequiredSecret,
+    SearchStrategy,
     SendResult,
     ServerConnection,
     SessionConfig,
     SessionInfo,
     SessionStatus,
+    ShipAction,
+    ShipAddress,
+    ShipArgs,
+    ShipItem,
+    ShipResult,
+    ShipServiceLevel,
     StreamEvent,
     Tool,
     ToolCallRecord,
@@ -59,9 +84,13 @@ from .types import (
     ToolResultEvent,
     ToolUseEvent,
     UserMessageEvent,
+    VerificationStatus,
+    VerificationStatusEvent,
+    VerificationStatusResult,
+    WizardAction,
 )
 
-__version__ = "0.3.0"
+__version__ = "0.9.0"
 
 __all__ = [
     "ApiError",
@@ -71,20 +100,43 @@ __all__ = [
     # Connect Links
     "AuthConfig",
     "AuthResult",
+    # Inbound charge (codespar_charge)
+    "ChargeArgs",
+    "ChargeBuyer",
+    "ChargeMethod",
+    "ChargeResult",
     # Clients
     "CodeSpar",
     # Errors
     "CodeSparError",
     "ConfigError",
+    # Connection wizard (codespar_manage_connections)
+    "ConnectionDifficulty",
+    "ConnectionStatus",
+    "ConnectionStatusRow",
+    "ConnectionWizardInstructions",
+    "ConnectionWizardOptions",
+    "ConnectionWizardResult",
+    # Tool discovery (codespar_discover)
+    "DiscoverOptions",
+    "DiscoverPlanStep",
+    "DiscoverResult",
+    "DiscoverToolMatch",
     "DoneEvent",
     "ErrorEvent",
     "HttpMethod",
     "ManageConnections",
     "NotConnectedError",
+    # Async settlement (codespar_pay etc.)
+    "PaymentStatus",
+    "PaymentStatusEvent",
+    "PaymentStatusResult",
     "Preset",
     # Proxy
     "ProxyRequest",
     "ProxyResult",
+    "RequiredSecret",
+    "SearchStrategy",
     "SendResult",
     "ServerConnection",
     "Session",
@@ -93,6 +145,13 @@ __all__ = [
     # Session output
     "SessionInfo",
     "SessionStatus",
+    # Shipping (codespar_ship)
+    "ShipAction",
+    "ShipAddress",
+    "ShipArgs",
+    "ShipItem",
+    "ShipResult",
+    "ShipServiceLevel",
     "StreamError",
     # Streaming events
     "StreamEvent",
@@ -102,6 +161,11 @@ __all__ = [
     "ToolResultEvent",
     "ToolUseEvent",
     "UserMessageEvent",
+    # Async KYC verification (codespar_kyc)
+    "VerificationStatus",
+    "VerificationStatusEvent",
+    "VerificationStatusResult",
+    "WizardAction",
     # Version
     "__version__",
 ]