Metadata-Version: 2.4
Name: pisama
Version: 0.1.0
Summary: Multi-agent failure detection for production AI systems
Project-URL: Homepage, https://pisama.ai
Project-URL: Documentation, https://docs.pisama.ai
Project-URL: Repository, https://github.com/tn-pisama/pisama
Author-email: Pisama Team <team@pisama.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,failure-detection,monitoring,multi-agent,observability
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: pisama-core>=1.0.0
Requires-Dist: rich>=13.0
Provides-Extra: auto
Requires-Dist: opentelemetry-api>=1.20.0; extra == 'auto'
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'auto'
Requires-Dist: pisama-auto>=0.1.0; extra == 'auto'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Description-Content-Type: text/markdown

# Pisama

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

Multi-agent failure detection for production AI systems. Runs locally, no API key needed.

## Install

```bash
pip install pisama
```

## Quick Start

```python
import pisama

result = pisama.analyze("trace.json")
for issue in result.issues:
    print(f"[{issue.type}] {issue.summary} (severity={issue.severity})")
```

## CLI

```bash
# Analyze a trace file
pisama analyze trace.json

# List available detectors
pisama detectors
```

## Detectors

Pisama ships with 18 failure detectors that run locally:

| Detector | Catches |
|---|---|
| loop | Exact, structural, and semantic loops |
| corruption | State corruption and invalid transitions |
| persona_drift | Persona drift and role confusion |
| coordination | Agent handoff and communication failures |
| hallucination | Factual inaccuracy in agent output |
| injection | Prompt injection attempts |
| overflow | Context window exhaustion |
| derailment | Task focus deviation |
| context | Context neglect in responses |
| communication | Inter-agent communication breakdown |
| specification | Output vs specification mismatch |
| decomposition | Task breakdown failures |
| workflow | Workflow execution issues |
| withholding | Information withholding |
| completion | Premature or delayed task completion |
| cost | Token and cost budget overruns |
| convergence | Metric plateau, regression, and divergence |
| repetition | Repetitive output patterns |

## Docs

Full documentation: [docs.pisama.ai](https://docs.pisama.ai)

## License

MIT
