Metadata-Version: 2.4
Name: watchlight-engine
Version: 0.1.1
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Intended Audience :: Developers
License-File: LICENSE
Summary: In-process Watchlight policy engine — the Developer Edition backend. Zero-infrastructure ALLOW/DENY authorization for AI agents.
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Documentation, https://docs.watchlight.ai
Project-URL: Homepage, https://watchlight.ai

# watchlight-engine

**The in-process authorization engine behind [Watchlight](https://watchlight.ai) Developer Edition.**

`watchlight-engine` lets a Python agent make a real authorization decision —
`ALLOW` / `DENY` — for a tool call, in-process, with **zero infrastructure**: no
database, no network, no sidecar. It ships as a prebuilt, self-contained
compiled wheel.

> **Most developers want the [`watchlight`](https://pypi.org/project/watchlight/)
> package**, the Developer Edition with an ergonomic decorator API. This
> `watchlight-engine` package is the lower-level engine it embeds — install it
> directly only if you are building on the engine yourself.

## Install

```bash
pip install watchlight-engine
```

Prebuilt wheels are provided for Linux (x86_64, aarch64), macOS (Apple Silicon
and Intel), and Windows (x64), for CPython 3.9 and newer. No Rust toolchain is
required.

## Quickstart

```python
import watchlight_engine

engine = watchlight_engine.PolicyEngine()
assert engine.ready()

# Load a policy, then authorize a request — a real decision, in-process.
engine.add_policy(policy_json)
decision = engine.authorize(request_json)
print(decision)   # -> Allow / Deny with the governing reason
```

See the [Watchlight documentation](https://docs.watchlight.ai) for policy and
request shapes, and the Developer Edition guide for the full workflow.

## What you get

- A real, in-process policy decision — the same authorization engine that powers
  the Watchlight platform, embedded so you can enforce governance without
  standing up any services.
- Fail-closed by design: ambiguity denies.
- A single prebuilt wheel per platform — install and go.

## Developer Edition vs. Enterprise

The Developer Edition is for building and evaluating locally. The full
Watchlight platform adds the governed control plane — centralized policy,
tamper-evident lineage and audit, runtime enforcement across your fleet, drift
and anomaly detection, secrets brokering, and the operator dashboard. See
[watchlight.ai](https://watchlight.ai) to learn more.

## License

Proprietary — licensed software, not open source. Copyright © Watchlight AI, LLC.
All rights reserved.

The Developer Edition license lets you **install and use `watchlight-engine` for
free for internal development, testing, and evaluation**. Production, commercial,
or third-party-service use requires a commercial license — contact
`legal@watchlight.ai`. Redistribution, reverse-engineering, and sublicensing are
not permitted. See the bundled `LICENSE` for the full terms.

