Metadata-Version: 2.4
Name: minuet-agentkit-actions
Version: 0.1.0
Summary: Coinbase AgentKit action provider for Minuet — the relationship layer for ERC-8004 AI agents.
Project-URL: Homepage, https://minuet.ai
Project-URL: Repository, https://github.com/minuetai/minuet-agentkit-actions
Project-URL: Issues, https://github.com/minuetai/minuet-agentkit-actions/issues
Author: Minuet Labs
License: MIT
License-File: LICENSE
Keywords: agentkit,ai-agents,coinbase-agentkit,erc-8004,minuet
Classifier: Development Status :: 4 - Beta
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: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: coinbase-agentkit>=0.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Description-Content-Type: text/markdown

# minuet-agentkit-actions

Coinbase AgentKit action provider for [Minuet](https://minuet.ai) — the relationship layer for ERC-8004 AI agents.

Exposes Minuet's relationship graph as four read-only AgentKit actions, so an
AgentKit agent can search for ERC-8004 agents by name, fetch identity and
relationship signals for a counterparty, and read aggregate network stats.

## Install

```bash
pip install minuet-agentkit-actions
```

Requires Python 3.10+.

## Usage

Register the provider when constructing your AgentKit instance:

```python
from coinbase_agentkit import AgentKit, AgentKitConfig
from minuet_agentkit_actions import minuet_action_provider

agentkit = AgentKit(AgentKitConfig(
    wallet_provider=...,
    action_providers=[minuet_action_provider()],
))
```

The four actions then surface in `agentkit.get_actions()` alongside any other
providers you've registered, with names prefixed `MinuetActionProvider_`.

## Actions

| Name | Description |
| --- | --- |
| `search_agents` | Search indexed ERC-8004 agents by name. |
| `check_counterparty` | Fetch an agent's record plus the relationships it appears in (status: `inferred` / `proposed` / `verified`). |
| `get_hub_agents` | Most-connected agents in the relationship graph. |
| `get_network_stats` | Aggregate counts: relationships, agents, named, by status, by relationship type. |

All actions hit the public Minuet HTTP API. Write routes (claim, propose,
confirm) are wallet-gated and intentionally not exposed.

## Configuration

| Env var | Default | Purpose |
| --- | --- | --- |
| `MINUET_API_URL` | `https://minuet.ai` | Override the API base URL (e.g. for local development). |

## Stack

ERC-8004 gives agents on-chain identity. A2A gives them tasks. x402 gives them
payments. Minuet is the relationship layer — bilateral verified records of
which agents work with which.

## License

MIT — see `LICENSE`.
