# 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
```
