Metadata-Version: 2.4
Name: clawtrak-gateway
Version: 0.1.0
Summary: Python SDK for the Claw Agent Gateway
Author-email: "Pixel Familiar Inc." <hello@pixelfamiliar.ca>
License: MIT
Project-URL: Homepage, https://gateway.clawtrak.com
Project-URL: Documentation, https://gateway.clawtrak.com/docs
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# clawtrak-gateway

Python SDK for the Claw Agent Gateway. Zero runtime dependencies.

## Install

```bash
pip install clawtrak-gateway
```

## Quick Start

```python
from clawtrak_gateway import ClawGateway

gw = ClawGateway(token="claw_your_token_here")

# Read a page as HTML
page = gw.read("pixelfamiliar.ca", "/")
print(page.body)

# Get clean Markdown
md = gw.markdown("pixelfamiliar.ca", "/about")
print(md.body)

# Discover action contracts
actions = gw.actions("pixelfamiliar.ca")
for a in actions:
    print(f"{a.action_name}: {a.description}")

# Execute an action
result = gw.execute("pixelfamiliar.ca", "get_sitemap")
print(result.body)
```

## Configuration

```python
gw = ClawGateway(
    token="claw_...",                    # Required
    base_url="https://...",              # Default: production
    timeout=30,                          # Default: 30s
)
```

## Response

```python
@dataclass
class GatewayResponse:
    status: int
    headers: dict
    body: str
    verified: bool        # Was the agent verified?
    proxy_mode: str | None  # 'markdown' if ClawProxy converted
```
