Metadata-Version: 2.4
Name: vigil-agent-client
Version: 0.1.0
Summary: Python client for Vigil Cloud — cognitive infrastructure for AI agents
Author-email: Alex LaGuardia <alex@alexlaguardia.dev>
License: MIT
Project-URL: Homepage, https://vigil-agent.com
Project-URL: Documentation, https://github.com/AlexlaGuardia/Vigil
Project-URL: Repository, https://github.com/AlexlaGuardia/vigil-client
Keywords: vigil,ai-agents,awareness,mcp,cognitive
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# vigil-client

Python client for [Vigil Cloud](https://vigil-agent.com) — cognitive infrastructure for AI agents.

## Install

```bash
pip install vigil-client
```

## Quick Start

```python
from vigil_client import Vigil

v = Vigil(api_key="vgl_...")

# Emit a signal
v.signal("deploy complete", agent="my-bot")

# Boot with compiled awareness
context = v.boot()
print(context["awareness"])

# End session with handoff
v.handoff(
    agent="my-bot",
    summary="Deployed auth v2",
    files=["auth.py", "middleware.py"],
    next_steps=["Monitor error rates", "Update docs"],
)
```

## Environment Variables

```bash
export VIGIL_API_KEY=vgl_...
export VIGIL_API_URL=https://app.vigil-agent.com  # optional, this is the default
```

```python
# Reads from env automatically
v = Vigil()
```

## API Reference

| Method | Description |
|--------|-------------|
| `v.signal(content, agent, signal_type)` | Emit a signal |
| `v.boot()` | Boot with compiled awareness |
| `v.compile()` | Force awareness compilation |
| `v.status()` | Get current awareness |
| `v.signals(hours, limit, agent)` | Read recent signals |
| `v.handoff(agent, summary, files, decisions, next_steps)` | End session |
| `v.resume(agent)` | Resume from last handoff |
| `v.chain(limit)` | Get handoff briefing |
| `v.focus_add(description, priority)` | Add focus item |
| `v.focus_list()` | List active focus |
| `v.know(key, value, category)` | Store knowledge |
| `v.recall(query)` | Search knowledge |
| `v.frames()` | List frames |
| `v.triggers()` | List triggers |
| `v.usage()` | Get usage and limits |
| `v.agents()` | List known agents |

## Zero Dependencies

Uses only Python stdlib (`urllib`, `json`). No `requests`, no `httpx` — just works.

## License

MIT
