Metadata-Version: 2.4
Name: agent-loop-runtime
Version: 0.1.0
Summary: Portable, local-first self-check runtime for humans, agents, and agentic apps.
Author: Mind Loops Lab
License-Expression: MIT
Project-URL: Homepage, https://github.com/Slaythar/Mind_Loops_Lab
Project-URL: Documentation, https://github.com/Slaythar/Mind_Loops_Lab/tree/main/agent_loop_runtime#readme
Project-URL: Source, https://github.com/Slaythar/Mind_Loops_Lab
Keywords: agents,ai-safety,local-first,runtime,self-check,cyber-safety
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Agent Loop Runtime

Agent Loop Runtime is a portable, local-first self-check layer for coding agents and agentic apps.

It is built for one practical failure mode: an agent is about to act or make a strong claim, and it needs a cheap reminder to ask, verify, or stop before the mistake becomes expensive.

It is not a cloud service, a monitor, a policy oracle, or a general lie detector. It reads only the explicit text and files you give it.

## Install

After the package is published:

```bash
pip install agent-loop-runtime
```

From a source checkout:

```bash
python -m agent_loop_runtime doctor --compact
python -m agent_loop_runtime release-check --compact
```

## Quick use

```bash
agent-loop-runtime check --action "inspect this workspace read-only" --compact
```

Typical signals:

- `PASS` means continue within the stated scope.
- `WARN` means label uncertainty or verify before claiming.
- `ASK` means ask before expanding scope or taking a write/external/private action.
- `BLOCK` means do not proceed as stated.

## Why it exists

Agent Loop Runtime turns a few useful habits into reusable infrastructure:

- authorization checks before actions;
- guess and evidence checks before strong claims;
- compact signals that humans and agents can both consume;
- local schemas and examples for repeatable integration.

The design goal is boring reliability: small checks, explicit boundaries, no unnecessary token burn, and no hidden network behavior.

## Documentation

- [Quickstart](agent_loop_runtime/QUICKSTART.md)
- [Runtime manual](agent_loop_runtime/README.md)
- [Threat model](agent_loop_runtime/THREAT_MODEL.md)
- [CI notes](CI.md)
- [Packaging notes](PACKAGING.md)

## Project

Mind Loops Lab is directed by one human owner, implemented with Codex, and reviewed with Claude as an independent second set of eyes.

License: MIT.
