dobby-ai-sdk 0.1.0__tar.gz

dobby_ai_sdk-0.1.0/.gitignore

@@ -0,0 +1,82 @@
+# ============================================
+# Dobby Platform - Git Ignore
+# ============================================
+
+# Environment Variables (CRITICAL - Never commit!)
+.env
+.env.local
+.env.dev
+.env.prod
+.env.*.local
+.env.*.backup
+*.backup
+
+# Credentials & Secrets
+/credentials/
+*.pem
+*.key
+service-account.json
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+*.egg-info/
+.eggs/
+
+# Node
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Next.js
+.next/
+out/
+build/
+dist/
+
+# Debug
+*.log
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+coverage/
+.nyc_output/
+test-results-*.json
+testing_sessions/
+
+# Build output artifacts
+tsc-*.txt
+test_write.txt
+
+# Docker
+docker-compose.override.yml
+
+# OS
+Thumbs.db
+
+# Backups
+backups/
+
+# Claude settings (local)
+.claude/settings.local.json
+
+# ============================================
+# Render Monitor
+# ============================================
+render-monitor/.env
+render-monitor/logs/
+render-monitor/*.log
+render-monitor/*.jsonl
+.venv/

dobby_ai_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: dobby-ai-sdk
+Version: 0.1.0
+Summary: Official Python SDK for the Dobby AI Platform — Home for your AI agents
+Project-URL: Homepage, https://dobby-ai.com
+Project-URL: Documentation, https://dobby-ai.com/docs/sdk
+Project-URL: Repository, https://github.com/gil-dobby/dobby-sdk-python
+Author-email: Dobby AI <dev@dobby-ai.com>
+License-Expression: MIT
+Keywords: a2a,agents,ai,dobby,gateway,llm,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: openai>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Dobby SDK for Python
+
+Official Python SDK for the [Dobby AI Platform](https://dobby-ai.com) — Home for your AI agents.
+
+## Installation
+
+```bash
+pip install dobby-ai-sdk
+```
+
+## Quick Start
+
+```python
+from dobby_sdk import DobbyClient
+
+client = DobbyClient(api_key="gk_user_...")
+
+# LLM calls (OpenAI-compatible)
+response = client.chat.completions.create(
+    model="claude-sonnet-4-20250514",
+    messages=[{"role": "user", "content": "Hello from Dobby!"}],
+)
+print(response.choices[0].message.content)
+
+# Streaming
+stream = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Explain AI agents"}],
+    stream=True,
+)
+for chunk in stream:
+    print(chunk.choices[0].delta.content or "", end="")
+```
+
+## Task Management
+
+```python
+# Create a task
+task = client.tasks.create(
+    title="Review PR #42",
+    priority="high",
+    agent_name="dobby-code-reviewer-agent",
+)
+
+# List pending tasks
+tasks = client.tasks.list(status="pending")
+
+# Approve a task (HITL)
+client.approvals.approve(task["id"], comment="Looks good!")
+```
+
+## Agent Fleet
+
+```python
+# List all agents
+agents = client.agents.list()
+
+# Register an external agent
+agent = client.agents.register(
+    display_name="Research Agent",
+    framework="crewai",
+    protocol="a2a",
+    endpoint_url="https://my-agent.example.com",
+)
+
+# Pause/resume
+client.agents.pause("agent_abc123")
+```
+
+## Cost Tracking
+
+```python
+# Organization cost summary
+costs = client.costs.summary(period="30d")
+
+# Per-agent breakdown
+agent_costs = client.costs.by_agent(period="7d")
+```
+
+## Async Support
+
+```python
+from dobby_sdk import AsyncDobbyClient
+
+async with AsyncDobbyClient(api_key="gk_user_...") as client:
+    response = await client.chat.completions.create(
+        model="claude-sonnet-4-20250514",
+        messages=[{"role": "user", "content": "Hello async!"}],
+    )
+```
+
+## Configuration
+
+```python
+client = DobbyClient(
+    api_key="gk_user_...",         # or DOBBY_API_KEY env var
+    base_url="https://dobby-ai.com",  # or DOBBY_BASE_URL
+    org_id="org_...",              # or DOBBY_ORG_ID
+    tenant_id="tenant_...",        # or DOBBY_TENANT_ID
+    timeout=120.0,
+    max_retries=2,
+)
+```
+
+## Error Handling
+
+```python
+from dobby_sdk import DobbyAuthError, DobbyRateLimitError, DobbyBudgetExceededError
+
+try:
+    response = client.chat.completions.create(...)
+except DobbyAuthError:
+    print("Invalid or expired API key")
+except DobbyRateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}s")
+except DobbyBudgetExceededError:
+    print("Organization budget limit reached")
+```

dobby_ai_sdk-0.1.0/README.md

@@ -0,0 +1,118 @@
+# Dobby SDK for Python
+
+Official Python SDK for the [Dobby AI Platform](https://dobby-ai.com) — Home for your AI agents.
+
+## Installation
+
+```bash
+pip install dobby-ai-sdk
+```
+
+## Quick Start
+
+```python
+from dobby_sdk import DobbyClient
+
+client = DobbyClient(api_key="gk_user_...")
+
+# LLM calls (OpenAI-compatible)
+response = client.chat.completions.create(
+    model="claude-sonnet-4-20250514",
+    messages=[{"role": "user", "content": "Hello from Dobby!"}],
+)
+print(response.choices[0].message.content)
+
+# Streaming
+stream = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Explain AI agents"}],
+    stream=True,
+)
+for chunk in stream:
+    print(chunk.choices[0].delta.content or "", end="")
+```
+
+## Task Management
+
+```python
+# Create a task
+task = client.tasks.create(
+    title="Review PR #42",
+    priority="high",
+    agent_name="dobby-code-reviewer-agent",
+)
+
+# List pending tasks
+tasks = client.tasks.list(status="pending")
+
+# Approve a task (HITL)
+client.approvals.approve(task["id"], comment="Looks good!")
+```
+
+## Agent Fleet
+
+```python
+# List all agents
+agents = client.agents.list()
+
+# Register an external agent
+agent = client.agents.register(
+    display_name="Research Agent",
+    framework="crewai",
+    protocol="a2a",
+    endpoint_url="https://my-agent.example.com",
+)
+
+# Pause/resume
+client.agents.pause("agent_abc123")
+```
+
+## Cost Tracking
+
+```python
+# Organization cost summary
+costs = client.costs.summary(period="30d")
+
+# Per-agent breakdown
+agent_costs = client.costs.by_agent(period="7d")
+```
+
+## Async Support
+
+```python
+from dobby_sdk import AsyncDobbyClient
+
+async with AsyncDobbyClient(api_key="gk_user_...") as client:
+    response = await client.chat.completions.create(
+        model="claude-sonnet-4-20250514",
+        messages=[{"role": "user", "content": "Hello async!"}],
+    )
+```
+
+## Configuration
+
+```python
+client = DobbyClient(
+    api_key="gk_user_...",         # or DOBBY_API_KEY env var
+    base_url="https://dobby-ai.com",  # or DOBBY_BASE_URL
+    org_id="org_...",              # or DOBBY_ORG_ID
+    tenant_id="tenant_...",        # or DOBBY_TENANT_ID
+    timeout=120.0,
+    max_retries=2,
+)
+```
+
+## Error Handling
+
+```python
+from dobby_sdk import DobbyAuthError, DobbyRateLimitError, DobbyBudgetExceededError
+
+try:
+    response = client.chat.completions.create(...)
+except DobbyAuthError:
+    print("Invalid or expired API key")
+except DobbyRateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}s")
+except DobbyBudgetExceededError:
+    print("Organization budget limit reached")
+```

dobby_ai_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dobby-ai-sdk"
+version = "0.1.0"
+description = "Official Python SDK for the Dobby AI Platform — Home for your AI agents"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Dobby AI", email = "dev@dobby-ai.com" },
+]
+keywords = ["ai", "agents", "llm", "gateway", "dobby", "a2a", "mcp"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "openai>=1.0.0",
+    "httpx>=0.25.0",
+    "pydantic>=2.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.23.0",
+    "pytest-httpx>=0.30.0",
+    "ruff>=0.3.0",
+    "mypy>=1.8.0",
+]
+
+[project.urls]
+Homepage = "https://dobby-ai.com"
+Documentation = "https://dobby-ai.com/docs/sdk"
+Repository = "https://github.com/gil-dobby/dobby-sdk-python"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dobby_sdk"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]
+
+[tool.mypy]
+strict = true
+python_version = "3.9"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

dobby_ai_sdk-0.1.0/src/dobby_sdk/__init__.py

@@ -0,0 +1,50 @@
+"""
+Dobby AI SDK — Official Python client for the Dobby AI Platform.
+
+Usage:
+    from dobby_sdk import DobbyClient
+
+    client = DobbyClient(api_key="gk_user_...")
+
+    # LLM calls (OpenAI-compatible)
+    response = client.chat.completions.create(
+        model="claude-sonnet-4-20250514",
+        messages=[{"role": "user", "content": "Hello"}]
+    )
+
+    # Task management
+    task = client.tasks.create(title="Review PR #42", priority="high")
+
+    # Agent operations
+    agents = client.agents.list()
+
+    # Approvals
+    pending = client.approvals.list(status="pending")
+
+    # Cost tracking
+    costs = client.costs.summary(period="30d")
+"""
+
+from dobby_sdk._config import DobbyConfig
+from dobby_sdk._exceptions import (
+    DobbyAuthError,
+    DobbyBudgetExceededError,
+    DobbyError,
+    DobbyNotFoundError,
+    DobbyRateLimitError,
+    DobbyServerError,
+)
+from dobby_sdk.client import AsyncDobbyClient, DobbyClient
+
+__version__ = "0.1.0"
+__all__ = [
+    "DobbyClient",
+    "AsyncDobbyClient",
+    "DobbyConfig",
+    "DobbyError",
+    "DobbyAuthError",
+    "DobbyRateLimitError",
+    "DobbyBudgetExceededError",
+    "DobbyNotFoundError",
+    "DobbyServerError",
+]

dobby_ai_sdk-0.1.0/src/dobby_sdk/_base.py

@@ -0,0 +1,83 @@
+"""Base HTTP client for Dobby API calls."""
+
+from __future__ import annotations
+
+import uuid
+from typing import Any
+
+import httpx
+
+from dobby_sdk._config import DobbyConfig
+from dobby_sdk._exceptions import raise_for_status
+
+
+class BaseResource:
+    """Base class for all API resource namespaces."""
+
+    def __init__(self, config: DobbyConfig, http_client: httpx.Client) -> None:
+        self._config = config
+        self._http = http_client
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        json: dict[str, Any] | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Make an authenticated API request."""
+        url = f"{self._config.api_url}{path}"
+        headers = {
+            **self._config.auth_headers,
+            "X-Request-Id": str(uuid.uuid4()),
+        }
+
+        response = self._http.request(
+            method=method,
+            url=url,
+            json=json,
+            params=params,
+            headers=headers,
+            timeout=self._config.timeout,
+        )
+
+        body = response.json() if response.content else {}
+        raise_for_status(response.status_code, body)
+        return body
+
+
+class AsyncBaseResource:
+    """Async version of BaseResource."""
+
+    def __init__(self, config: DobbyConfig, http_client: httpx.AsyncClient) -> None:
+        self._config = config
+        self._http = http_client
+
+    async def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        json: dict[str, Any] | None = None,
+        params: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Make an authenticated async API request."""
+        url = f"{self._config.api_url}{path}"
+        headers = {
+            **self._config.auth_headers,
+            "X-Request-Id": str(uuid.uuid4()),
+        }
+
+        response = await self._http.request(
+            method=method,
+            url=url,
+            json=json,
+            params=params,
+            headers=headers,
+            timeout=self._config.timeout,
+        )
+
+        body = response.json() if response.content else {}
+        raise_for_status(response.status_code, body)
+        return body

dobby_ai_sdk-0.1.0/src/dobby_sdk/_config.py

@@ -0,0 +1,50 @@
+"""SDK configuration."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+
+
+@dataclass
+class DobbyConfig:
+    """Configuration for the Dobby SDK client."""
+
+    api_key: str = field(default_factory=lambda: os.environ.get("DOBBY_API_KEY", ""))
+    base_url: str = field(
+        default_factory=lambda: os.environ.get("DOBBY_BASE_URL", "https://dobby-ai.com")
+    )
+    org_id: str | None = field(default_factory=lambda: os.environ.get("DOBBY_ORG_ID"))
+    tenant_id: str | None = field(default_factory=lambda: os.environ.get("DOBBY_TENANT_ID"))
+    timeout: float = 120.0
+    max_retries: int = 2
+
+    def __post_init__(self) -> None:
+        if not self.api_key:
+            raise ValueError(
+                "API key is required. Pass api_key= or set DOBBY_API_KEY environment variable."
+            )
+        self.base_url = self.base_url.rstrip("/")
+
+    @property
+    def gateway_url(self) -> str:
+        """Base URL for gateway API calls."""
+        return f"{self.base_url}/api/v1/gateway"
+
+    @property
+    def api_url(self) -> str:
+        """Base URL for platform API calls."""
+        return f"{self.base_url}/api/v1"
+
+    @property
+    def auth_headers(self) -> dict[str, str]:
+        """Headers required for all API calls."""
+        headers: dict[str, str] = {
+            "Authorization": f"Bearer {self.api_key}",
+            "User-Agent": "dobby-sdk-python/0.1.0",
+        }
+        if self.org_id:
+            headers["X-Org-Id"] = self.org_id
+        if self.tenant_id:
+            headers["X-Tenant-Id"] = self.tenant_id
+        return headers

dobby_ai_sdk-0.1.0/src/dobby_sdk/_exceptions.py

@@ -0,0 +1,84 @@
+"""SDK exception hierarchy."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class DobbyError(Exception):
+    """Base exception for all Dobby SDK errors."""
+
+    def __init__(
+        self,
+        message: str,
+        status_code: int | None = None,
+        body: dict[str, Any] | None = None,
+    ) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body or {}
+
+    @property
+    def error_code(self) -> str | None:
+        return self.body.get("error")
+
+    @property
+    def error_message(self) -> str | None:
+        return self.body.get("message")
+
+
+class DobbyAuthError(DobbyError):
+    """Authentication failed — invalid, expired, or revoked API key."""
+    pass
+
+
+class DobbyRateLimitError(DobbyError):
+    """Rate limit exceeded for this API key tier."""
+
+    def __init__(
+        self,
+        message: str,
+        retry_after: float | None = None,
+        **kwargs: object,
+    ):
+        super().__init__(message, **kwargs)  # type: ignore[arg-type]
+        self.retry_after = retry_after
+
+
+class DobbyBudgetExceededError(DobbyError):
+    """Organization or tenant budget limit reached."""
+    pass
+
+
+class DobbyNotFoundError(DobbyError):
+    """Requested resource not found."""
+    pass
+
+
+class DobbyServerError(DobbyError):
+    """Server-side error (5xx)."""
+    pass
+
+
+def raise_for_status(status_code: int, body: dict[str, Any]) -> None:
+    """Raise appropriate exception based on HTTP status code."""
+    if status_code < 400:
+        return
+
+    message = body.get("message") or body.get("error") or f"HTTP {status_code}"
+
+    if status_code == 401:
+        raise DobbyAuthError(message, status_code=status_code, body=body)
+    elif status_code == 403:
+        error_code = body.get("error", "")
+        if "budget" in error_code.lower() or "budget" in message.lower():
+            raise DobbyBudgetExceededError(message, status_code=status_code, body=body)
+        raise DobbyAuthError(message, status_code=status_code, body=body)
+    elif status_code == 404:
+        raise DobbyNotFoundError(message, status_code=status_code, body=body)
+    elif status_code == 429:
+        raise DobbyRateLimitError(message, status_code=status_code, body=body)
+    elif status_code >= 500:
+        raise DobbyServerError(message, status_code=status_code, body=body)
+    else:
+        raise DobbyError(message, status_code=status_code, body=body)