Metadata-Version: 2.4
Name: watchdog_ultrec
Version: 0.1.0
Summary: Watchdog: a free, local watcher for AI agents. Flags missing heartbeats, spend spikes, action loops, and leaked secrets. Observes and alerts; never controls by default.
Author-email: Ultrec AI Inc <hello@ultrecai.com>
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: yaml
Requires-Dist: PyYAML>=6; extra == "yaml"
Dynamic: license-file

# Watchdog™ by Ultrec AI Inc — v0.1.0

A free, local watcher for your AI agents. Watchdog reads your agents' logs and
flags trouble in plain English. It **observes and alerts**; it never controls
your agents by default.

## Checks (rule-based, deterministic)
- **Heartbeat** — agent silent longer than `max_silence_seconds`, or never sent one
- **Spend** — single call far above the running average (spike) or total over `cap_usd`
- **Loop** — same action + args repeated more than `max_repeats` times in a row
- **Secrets** — API keys, private keys, password assignments in output (redacted in reports)

## Install & run
    pip install watchdog_ultrec-0.1.0-py3-none-any.whl    # or: unzip, cd watchdog-0.1.0, pip install .
    watchdog demo
    watchdog watch --config examples/watchdog.json --report incidents.md

Exit code: 0 = clear/minor, 1 = high-severity incident. Standard library only
(Python 3.9+). YAML config is optional (`pip install pyyaml`); JSON works with no extras.
The Python import is `watchdog_ultrec` (the PyPI name `watchdog` belongs to another project).

## Log format
JSONL lines with `ts`, `agent`, `type` (`heartbeat`, `action`, `llm_call`, `output`…),
plus optional `cost_usd`, `action`, `args`, `text`. Plain lines `TS AGENT TYPE text` also work.

## Off by default
- `ai.enabled` — optional AI summaries (stub in v0.1.0)
- `pause_hook.enabled` — writes a pause file your own system may honor; kills nothing

## Disclaimer
Watchdog is provided AS IS under the MIT License. It is a monitoring aid and does
not guarantee the safety, correctness, or cost of any AI system.

Watchdog™ is a trademark brand of Ultrec AI Inc.
