Metadata-Version: 2.5
Name: ratchet-authz-core
Version: 0.1.0
Summary: Framework-agnostic authorization broker for multi-agent LLM delegation.
Project-URL: Homepage, https://github.com/1manideep/ratchet
Project-URL: Repository, https://github.com/1manideep/ratchet
Project-URL: Issues, https://github.com/1manideep/ratchet/issues
Author: Manideep Pendyala
License-Expression: MIT
Keywords: agents,authorization,capability-tokens,llm,macaroons,security
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: cryptography>=42.0
Description-Content-Type: text/markdown

# ratchet-authz-core

Framework-agnostic authorization broker core for **Ratchet** — an
open-source implementation of the delegation-authorization broker
described in [arXiv:2609.00267](https://arxiv.org/abs/2609.00267)
("Delegation Without Trust"). A fully prompt-hijacked LLM agent still
cannot exceed the authority explicitly delegated to it.

Implements workload identity, macaroon-style capability tokens, the
broker/PEP, hash-chained audit logging, and revocation. **Zero
third-party runtime dependencies** beyond the standard library and
`cryptography` (used only for Ed25519 workload identity keys).

## Install

```bash
pip install ratchet-authz-core
```

For a specific agent framework, install the matching adapter instead (it
pulls in `ratchet-authz-core` automatically): `ratchet-authz-langgraph`,
`ratchet-authz-crewai`, `ratchet-authz-autogen`, or `ratchet-authz-mcp`.

## Minimal usage

```python
from ratchet_core import Broker, Ed25519WorkloadIdentity, tool_name_caveat

broker = Broker()
primary = Ed25519WorkloadIdentity("primary-agent")
token = broker.issue(
    human_identity="alice@example.com",
    primary_identity=primary,
    caveats=[tool_name_caveat("read_calendar")],
)

decision = broker.authorize(
    token,
    presenting_identity=primary,
    proposed_tool_call=...,  # ratchet_core.ProposedToolCall
)
```

Full documentation, architecture diagram, and per-framework quickstarts:
https://github.com/1manideep/ratchet
