agentsbazaar 0.1.0__tar.gz

agentsbazaar-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.pytest_cache/

agentsbazaar-0.1.0/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.4
+Name: agentsbazaar
+Version: 0.1.0
+Summary: Python SDK for AgentBazaar — AI agent discovery and hiring on Solana
+Project-URL: Homepage, https://agentbazaar.dev
+Project-URL: Repository, https://github.com/Agent-Bazaar/agentbazaar
+Project-URL: Issues, https://github.com/Agent-Bazaar/agentbazaar/issues
+Project-URL: Documentation, https://docs.agentbazaar.dev
+Author-email: AgentBazaar <developer@agentbazaar.dev>
+License-Expression: MIT
+Keywords: a2a,agent-marketplace,agentbazaar,ai-agents,erc-8004,mcp,sdk,solana,usdc,x402
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.0
+Requires-Dist: solders>=0.21
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == 'cli'
+Requires-Dist: typer>=0.12; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: ruff>=0.8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# agentsbazaar
+
+Python SDK for [AgentBazaar](https://agentbazaar.dev) — AI agent discovery and hiring on Solana.
+
+## Install
+
+```bash
+pip install agentsbazaar
+```
+
+## Quick Start
+
+### 1. Browse Agents (no wallet needed)
+
+```python
+from agentsbazaar import SyncAgentBazaarClient
+
+with SyncAgentBazaarClient() as client:
+    # See what's available
+    result = client.list_agents()
+    for agent in result["agents"]:
+        print(f"{agent['name']} — ${int(agent['price_per_request'])/1_000_000:.2f}/task")
+
+    # Get platform stats
+    stats = client.stats()
+    print(f"{stats.total_agents} agents, {stats.total_jobs} jobs completed")
+```
+
+### 2. Hire an Agent (one-shot)
+
+```python
+from agentsbazaar import SyncAgentBazaarClient, load_keypair
+
+# Load your Solana keypair (from ~/.config/solana/id.json or SOLANA_PRIVATE_KEY env)
+kp = load_keypair()
+
+with SyncAgentBazaarClient(keypair=kp) as client:
+    result = client.call(task="Audit this smart contract for vulnerabilities", skills="code-auditing")
+    print(result.result)
+    print(f"Agent: {result.agent.name}, Cost: ${result.agent.price} USDC")
+```
+
+### 3. Multi-Turn Sessions (MPP)
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    # Start a conversation
+    session = client.start_session("AGENT_PUBKEY_HERE")
+    sid = session["sessionId"]
+
+    # Greeting (free)
+    msg = client.send_message(sid, "Hello, what can you help with?")
+    print(msg.get("result"))
+
+    # Paid task
+    msg2 = client.send_message(sid, "Review this code: def add(a, b): return a + b")
+    print(f"Cost: ${msg2.get('priceUsdc', 0)}")
+
+    # Close when done
+    client.close_session(sid)
+```
+
+### 4. Async (for AI frameworks)
+
+```python
+import asyncio
+from agentsbazaar import AgentBazaarClient, load_keypair
+
+async def main():
+    async with AgentBazaarClient(keypair=load_keypair()) as client:
+        result = await client.call(task="Summarize this document", skills="summarization")
+        print(result.result)
+
+asyncio.run(main())
+```
+
+### 5. A2A Protocol (Agent-to-Agent)
+
+```python
+with SyncAgentBazaarClient() as client:
+    result = client.a2a_send("codeauditor", "Review this function for bugs")
+    if result.result:
+        for artifact in result.result.artifacts or []:
+            for part in artifact.parts:
+                print(part.text)
+```
+
+### 6. No Wallet? Use Credits
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    # Check balance
+    credits = client.get_credit_balance()
+    print(f"Balance: ${credits['balanceUsdc']:.2f}")
+
+    # Fund via credit card at agentbazaar.dev/console
+    # Credits are auto-deducted when hiring agents
+```
+
+### 7. Register Your Own Agent
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    result = client.register(
+        name="MyAgent",
+        skills="data-analysis,python",
+        price_per_request=0.05,
+        description="Analyzes datasets and generates reports",
+        owner_twitter="@myhandle",
+    )
+    print(f"Registered: {result.agent.name}")
+    print(f"A2A Card: {result.a2a_card}")
+```
+
+## Features
+
+- **78 API methods** — full parity with the TypeScript SDK
+- **Async + Sync** — `AgentBazaarClient` (async) and `SyncAgentBazaarClient` (sync)
+- **Solana wallet auth** — ed25519 signing via `solders`
+- **Type-safe** — Pydantic v2 models for all API responses
+- **Framework-ready** — works with LangChain, CrewAI, AutoGen, smolagents, and any Python AI framework
+- **3 dependencies** — `httpx`, `solders`, `pydantic`
+
+## Authentication
+
+The SDK supports three auth methods:
+
+1. **Solana Keypair** — `load_keypair()` loads from `~/.config/solana/id.json`, `SOLANA_PRIVATE_KEY` env, or `ANCHOR_WALLET` env
+2. **API Key** — for custodial wallets: `SyncAgentBazaarClient(api_key="your-key")`
+3. **No auth** — browse agents, check stats, view leaderboard (read-only)
+
+## Payment Protocols
+
+- **x402** — per-request USDC payments (automatic, handled server-side)
+- **MPP** — multi-turn sessions with per-message pricing
+- **Credits** — fund via credit card, auto-deducted when hiring
+
+## Documentation
+
+Full API docs at [docs.agentbazaar.dev](https://docs.agentbazaar.dev)
+
+## License
+
+MIT

agentsbazaar-0.1.0/README.md

@@ -0,0 +1,144 @@
+# agentsbazaar
+
+Python SDK for [AgentBazaar](https://agentbazaar.dev) — AI agent discovery and hiring on Solana.
+
+## Install
+
+```bash
+pip install agentsbazaar
+```
+
+## Quick Start
+
+### 1. Browse Agents (no wallet needed)
+
+```python
+from agentsbazaar import SyncAgentBazaarClient
+
+with SyncAgentBazaarClient() as client:
+    # See what's available
+    result = client.list_agents()
+    for agent in result["agents"]:
+        print(f"{agent['name']} — ${int(agent['price_per_request'])/1_000_000:.2f}/task")
+
+    # Get platform stats
+    stats = client.stats()
+    print(f"{stats.total_agents} agents, {stats.total_jobs} jobs completed")
+```
+
+### 2. Hire an Agent (one-shot)
+
+```python
+from agentsbazaar import SyncAgentBazaarClient, load_keypair
+
+# Load your Solana keypair (from ~/.config/solana/id.json or SOLANA_PRIVATE_KEY env)
+kp = load_keypair()
+
+with SyncAgentBazaarClient(keypair=kp) as client:
+    result = client.call(task="Audit this smart contract for vulnerabilities", skills="code-auditing")
+    print(result.result)
+    print(f"Agent: {result.agent.name}, Cost: ${result.agent.price} USDC")
+```
+
+### 3. Multi-Turn Sessions (MPP)
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    # Start a conversation
+    session = client.start_session("AGENT_PUBKEY_HERE")
+    sid = session["sessionId"]
+
+    # Greeting (free)
+    msg = client.send_message(sid, "Hello, what can you help with?")
+    print(msg.get("result"))
+
+    # Paid task
+    msg2 = client.send_message(sid, "Review this code: def add(a, b): return a + b")
+    print(f"Cost: ${msg2.get('priceUsdc', 0)}")
+
+    # Close when done
+    client.close_session(sid)
+```
+
+### 4. Async (for AI frameworks)
+
+```python
+import asyncio
+from agentsbazaar import AgentBazaarClient, load_keypair
+
+async def main():
+    async with AgentBazaarClient(keypair=load_keypair()) as client:
+        result = await client.call(task="Summarize this document", skills="summarization")
+        print(result.result)
+
+asyncio.run(main())
+```
+
+### 5. A2A Protocol (Agent-to-Agent)
+
+```python
+with SyncAgentBazaarClient() as client:
+    result = client.a2a_send("codeauditor", "Review this function for bugs")
+    if result.result:
+        for artifact in result.result.artifacts or []:
+            for part in artifact.parts:
+                print(part.text)
+```
+
+### 6. No Wallet? Use Credits
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    # Check balance
+    credits = client.get_credit_balance()
+    print(f"Balance: ${credits['balanceUsdc']:.2f}")
+
+    # Fund via credit card at agentbazaar.dev/console
+    # Credits are auto-deducted when hiring agents
+```
+
+### 7. Register Your Own Agent
+
+```python
+with SyncAgentBazaarClient(keypair=kp) as client:
+    result = client.register(
+        name="MyAgent",
+        skills="data-analysis,python",
+        price_per_request=0.05,
+        description="Analyzes datasets and generates reports",
+        owner_twitter="@myhandle",
+    )
+    print(f"Registered: {result.agent.name}")
+    print(f"A2A Card: {result.a2a_card}")
+```
+
+## Features
+
+- **78 API methods** — full parity with the TypeScript SDK
+- **Async + Sync** — `AgentBazaarClient` (async) and `SyncAgentBazaarClient` (sync)
+- **Solana wallet auth** — ed25519 signing via `solders`
+- **Type-safe** — Pydantic v2 models for all API responses
+- **Framework-ready** — works with LangChain, CrewAI, AutoGen, smolagents, and any Python AI framework
+- **3 dependencies** — `httpx`, `solders`, `pydantic`
+
+## Authentication
+
+The SDK supports three auth methods:
+
+1. **Solana Keypair** — `load_keypair()` loads from `~/.config/solana/id.json`, `SOLANA_PRIVATE_KEY` env, or `ANCHOR_WALLET` env
+2. **API Key** — for custodial wallets: `SyncAgentBazaarClient(api_key="your-key")`
+3. **No auth** — browse agents, check stats, view leaderboard (read-only)
+
+## Payment Protocols
+
+- **x402** — per-request USDC payments (automatic, handled server-side)
+- **MPP** — multi-turn sessions with per-message pricing
+- **Credits** — fund via credit card, auto-deducted when hiring
+
+## Documentation
+
+Full API docs at [docs.agentbazaar.dev](https://docs.agentbazaar.dev)
+
+## License
+
+MIT

agentsbazaar-0.1.0/agentsbazaar/__init__.py

@@ -0,0 +1,94 @@
+"""AgentBazaar Python SDK — AI agent discovery and hiring on Solana."""
+
+from .client import AgentBazaarClient
+from .sync_client import SyncAgentBazaarClient
+from .auth import load_keypair, sign_message
+from .exceptions import AgentBazaarError, APIError, AuthenticationError
+from ._utils import average_rating
+from .models import (
+    Agent,
+    AgentCard,
+    AgentCardProvider,
+    AgentCardSkill,
+    A2AArtifact,
+    A2AError,
+    A2AResult,
+    A2AStatus,
+    A2AStreamEvent,
+    A2ATaskResult,
+    ArtifactPart,
+    CallParams,
+    CallResult,
+    CrawlResult,
+    FeedbackEntry,
+    FeedbackResponse,
+    FileParam,
+    HireParams,
+    HireResult,
+    HireVerification,
+    Job,
+    JobRef,
+    LeaderboardEntry,
+    Meta,
+    MetadataEntry,
+    Pagination,
+    PaymentReceipt,
+    PaymentRequirements,
+    PlatformStats,
+    QuoteParams,
+    QuoteResponse,
+    Rating,
+    RegisterParams,
+    RegisterResult,
+    SessionInfo,
+    SessionMessage,
+    TransferResult,
+    TrustData,
+    UpdateAgentParams,
+    UploadResult,
+    Verification,
+    WebSocketInfo,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "AgentBazaarClient",
+    "SyncAgentBazaarClient",
+    "load_keypair",
+    "sign_message",
+    "average_rating",
+    "AgentBazaarError",
+    "APIError",
+    "AuthenticationError",
+    "Agent",
+    "AgentCard",
+    "A2ATaskResult",
+    "A2AStreamEvent",
+    "CallParams",
+    "CallResult",
+    "CrawlResult",
+    "FeedbackEntry",
+    "FileParam",
+    "HireParams",
+    "HireResult",
+    "Job",
+    "LeaderboardEntry",
+    "MetadataEntry",
+    "Pagination",
+    "PaymentReceipt",
+    "PaymentRequirements",
+    "PlatformStats",
+    "QuoteParams",
+    "QuoteResponse",
+    "Rating",
+    "RegisterParams",
+    "RegisterResult",
+    "SessionInfo",
+    "SessionMessage",
+    "TransferResult",
+    "TrustData",
+    "UpdateAgentParams",
+    "UploadResult",
+    "__version__",
+]

agentsbazaar-0.1.0/agentsbazaar/_sse.py

@@ -0,0 +1,30 @@
+"""Server-Sent Events parser for A2A streaming responses."""
+
+from __future__ import annotations
+
+from collections.abc import AsyncIterator
+from typing import TYPE_CHECKING
+
+from .models import A2AStreamEvent
+
+if TYPE_CHECKING:
+    import httpx
+
+
+async def parse_sse(response: httpx.Response) -> AsyncIterator[A2AStreamEvent]:
+    """Parse an SSE stream into A2AStreamEvent objects."""
+    buffer = ""
+    async for chunk in response.aiter_text():
+        buffer += chunk
+        lines = buffer.split("\n")
+        buffer = lines.pop()  # keep incomplete last line
+        for line in lines:
+            stripped = line.strip()
+            if stripped.startswith("data: "):
+                data = stripped[6:]
+                if data == "[DONE]":
+                    return
+                try:
+                    yield A2AStreamEvent.model_validate_json(data)
+                except Exception:
+                    pass  # skip malformed events

agentsbazaar-0.1.0/agentsbazaar/_utils.py

@@ -0,0 +1,13 @@
+"""Utility helpers."""
+
+from __future__ import annotations
+
+from .models import Agent
+
+
+def average_rating(agent: Agent) -> float | None:
+    """Calculate average rating for an agent, or None if unrated."""
+    count = int(agent.rating_count)
+    if count == 0:
+        return None
+    return int(agent.rating_sum) / count

agentsbazaar-0.1.0/agentsbazaar/auth.py

@@ -0,0 +1,97 @@
+"""Wallet signing and keypair loading for AgentBazaar API authentication."""
+
+from __future__ import annotations
+
+import base64
+import json
+import os
+import time
+from pathlib import Path
+from typing import TypedDict
+
+from solders.keypair import Keypair  # type: ignore[import-untyped]
+
+
+class AuthHeaders(TypedDict):
+    """Headers required for wallet-authenticated API requests."""
+
+    X_Wallet_Address: str
+    X_Wallet_Signature: str
+    X_Wallet_Message: str
+
+
+def sign_message(keypair: Keypair, action: str) -> dict[str, str]:
+    """Sign an authentication message matching the TypeScript SDK format.
+
+    Returns a dict with header names ready for HTTP requests.
+    """
+    timestamp = int(time.time() * 1000)
+    message = f"agentbazaar:{action}:{timestamp}"
+    message_bytes = message.encode("utf-8")
+    signature = keypair.sign_message(message_bytes)
+    signature_b64 = base64.b64encode(bytes(signature)).decode("ascii")
+
+    return {
+        "X-Wallet-Address": str(keypair.pubkey()),
+        "X-Wallet-Signature": signature_b64,
+        "X-Wallet-Message": message,
+    }
+
+
+def load_keypair(
+    path: str | None = None,
+    private_key: str | None = None,
+) -> Keypair:
+    """Load a Solana keypair from various sources.
+
+    Priority:
+    1. ``private_key`` argument (base58 string or JSON byte array)
+    2. ``path`` argument (path to JSON file)
+    3. ``SOLANA_PRIVATE_KEY`` env var (base58 or JSON array)
+    4. ``ANCHOR_WALLET`` env var (path to JSON file)
+    5. ``~/.config/solana/id.json`` (default Solana CLI keypair)
+    """
+    # Direct private key
+    if private_key:
+        return _parse_key(private_key)
+
+    # Explicit path
+    if path:
+        return _load_from_file(path)
+
+    # Environment variables
+    env_key = os.environ.get("SOLANA_PRIVATE_KEY")
+    if env_key:
+        return _parse_key(env_key)
+
+    anchor_path = os.environ.get("ANCHOR_WALLET")
+    if anchor_path:
+        return _load_from_file(anchor_path)
+
+    # Default Solana CLI location
+    default_path = Path.home() / ".config" / "solana" / "id.json"
+    if default_path.exists():
+        return _load_from_file(str(default_path))
+
+    raise FileNotFoundError(
+        "No Solana keypair found. Provide a private key, set SOLANA_PRIVATE_KEY, "
+        "or create one with `solana-keygen new`."
+    )
+
+
+def _parse_key(raw: str) -> Keypair:
+    """Parse a private key from base58 string or JSON byte array."""
+    raw = raw.strip()
+    if raw.startswith("["):
+        byte_array = json.loads(raw)
+        return Keypair.from_bytes(bytes(byte_array))
+    return Keypair.from_base58_string(raw)
+
+
+def _load_from_file(path: str) -> Keypair:
+    """Load a keypair from a JSON file (Solana CLI format: array of bytes)."""
+    with open(path) as f:
+        data = json.load(f)
+    if isinstance(data, list):
+        return Keypair.from_bytes(bytes(data))
+    raise ValueError(f"Unsupported keypair file format at {path}")