Metadata-Version: 2.4
Name: composio-mnemopay
Version: 0.1.0
Summary: MnemoPay integration for Composio — persistent memory, micropayments, and trust scoring
Project-URL: Homepage, https://mnemopay.io
Project-URL: Documentation, https://docs.mnemopay.io
Project-URL: Repository, https://github.com/mnemopay/composio-mnemopay
Project-URL: Issues, https://github.com/mnemopay/composio-mnemopay/issues
Author-email: Jerry Omiagbo <jeremiah@getbizsuite.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,composio,memory,mnemopay,payment,trust
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.9
Requires-Dist: requests
Provides-Extra: composio
Requires-Dist: composio-core; extra == 'composio'
Description-Content-Type: text/markdown

# composio-mnemopay

MnemoPay integration for [Composio](https://composio.dev) -- persistent memory, micropayments, and trust scoring for AI agents.

## Installation

```bash
pip install composio-mnemopay
```

With Composio provider support:

```bash
pip install composio-mnemopay[composio]
```

## Quick start

### Standalone (no Composio dependency)

```python
from composio_mnemopay import MnemoPayClient

client = MnemoPayClient(server_url="https://mnemopay-mcp.fly.dev")

# Store a memory
result = client.call_tool("remember", {"content": "User prefers dark mode"})
print(result.value)

# Recall memories
result = client.call_tool("recall", {"query": "preferences"})
print(result.value)

# Check balance
result = client.call_tool("balance", {})
print(result.value)
```

### With Composio provider

```python
from composio import Composio
from composio_mnemopay import MnemoPayProvider

composio = Composio(provider=MnemoPayProvider())
tools = composio.tools.get(user_id="default", toolkits=["mnemopay"])
```

## Tools

| Category | Tool | Description |
|----------|------|-------------|
| Memory | `MNEMOPAY_REMEMBER` | Store a persistent memory |
| Memory | `MNEMOPAY_RECALL` | Semantic search over memories |
| Memory | `MNEMOPAY_FORGET` | Delete a memory by ID |
| Memory | `MNEMOPAY_REINFORCE` | Boost a memory's importance |
| Memory | `MNEMOPAY_CONSOLIDATE` | Prune stale memories |
| Payments | `MNEMOPAY_CHARGE` | Create an escrow charge |
| Payments | `MNEMOPAY_SETTLE` | Finalize a pending escrow |
| Payments | `MNEMOPAY_REFUND` | Refund a transaction |
| Observability | `MNEMOPAY_BALANCE` | Wallet balance + reputation |
| Observability | `MNEMOPAY_PROFILE` | Full agent stats |
| Observability | `MNEMOPAY_REPUTATION` | Detailed reputation report |
| Observability | `MNEMOPAY_LOGS` | Immutable audit trail |
| Observability | `MNEMOPAY_HISTORY` | Transaction history |

## Environment variables

| Variable | Default | Description |
|----------|---------|-------------|
| `MNEMOPAY_SERVER_URL` | `https://mnemopay-mcp.fly.dev` | MCP server endpoint |
| `MNEMOPAY_AGENT_ID` | `composio-agent` | Agent identifier |
| `MNEMOPAY_MODE` | `quick` | Server mode |

## License

MIT
