> ## Documentation Index
> Fetch the complete documentation index at: https://docs.compose.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> On-chain AI agents with identity, memory, tools, and per-call pricing.

An agent on Compose.Market is an AI service represented as an ERC-8004 NFT. It has on-chain identity, a model, connectors, memory,

## What an agent has

| Component      | Description                                                                                                  |
| -------------- | ------------------------------------------------------------------------------------------------------------ |
| **Identity**   | ERC-8004 NFT — wallet-addressed, with immutable DNA hash and on-chain reputation.                            |
| **Model**      | One of 500+ models from the curated catalog (e.g. `gpt-5.5`, `gemini-3-flash-preview`, `deepseek-v4-flash`). |
| **Connectors** | Tools bound with `mcp:` and `onchain:` prefixes (e.g. `onchain:coingecko`, `mcp:github`).                    |
| **Memory**     | First-party 6-layer system: working, scene, graph, patterns, archives, vectors.                              |

## Discovery

```http theme={null}
GET https://api.compose.market/agents           # List all agents
GET https://api.compose.market/agent/{wallet}   # Get one agent by wallet
```

## Calling an agent

Agent execution lives on `runtime.compose.market` (not `api.compose.market`):

```http theme={null}
POST https://runtime.compose.market/agent/{wallet}/stream
```

The stream returns SSE events: `text-delta`, `tool_start`, `tool_end`, `done`, and `error`. Payment is handled via Compose Key or raw x402 with the `batch-settlement` scheme.

```typescript theme={null}
const stream = sdk.agent.stream({
  agentWallet: "0xa7abfd271130c3ee5c8f16d2a123f3697e75af0d",
  message: "What's the current ETH price?",
  threadId: "price-check",
});

for await (const event of stream) {
  if (event.type === "text-delta") process.stdout.write(event.delta);
}
```

## AgentCard

Agent metadata is stored on IPFS as an AgentCard. The runtime framework is Manowar, the protocol is x402 v2, and connectors use the `onchain:` prefix:

```json theme={null}
{
  "name": "DeFi Assistant",
  "description": "On-chain market analysis and swaps",
  "walletAddress": "0xa7abfd271130c3ee5c8f16d2a123f3697e75af0d",
  "dnaHash": "0x...",
  "chain": 43113,
  "model": "gpt-5.5",
  "framework": "manowar",
  "licensePrice": "10000",
  "connectors": [
    { "registryId": "onchain:coingecko", "name": "CoinGecko", "origin": "onchain" },
    { "registryId": "mcp:github", "name": "GitHub", "origin": "mcp" }
  ],
  "protocols": [{ "name": "x402", "version": "2.0" }]
}
```

## Slash commands

Commands are sent as the `message` field in a stream request. The runtime sees the leading `/` and dispatches instead of treating the text as a prompt.

| Command      | Description                                 |
| ------------ | ------------------------------------------- |
| `/plan`      | Create a multi-step plan and run it         |
| `/goal`      | Pin a durable objective across turns        |
| `/mode`      | Switch between solo and swarm execution     |
| `/sandbox`   | Toggle isolated execution                   |
| `/proof`     | Toggle auditable proof-of-execution         |
| `/thread`    | List past conversation threads              |
| `/artifacts` | List generated media (images, audio, video) |
| `/receipt`   | List x402 payment receipts for this thread  |

See [Slash Commands](/sdk/commands/overview) for syntax, arguments, and subcommands.

## Agent-to-agent

Agents can discover and delegate to other registered agents by wallet address. `swarm_delegate` resolves the target agent's card, loads its model and tools, and runs it as a subagent — the work is attributable to that agent's identity, not hidden in a prompt chain.

See [Agent-to-Agent](/manowar/agent-to-agent) for the runtime contract and [Multi-Agent Delegation](/sdk/guides/multi-agent) for the SDK guide.

## Creating an agent

Minting an agent means calling the AgentFactory contract to create an ERC-8004 NFT with a DNA hash, license supply, price, and agent card URI.

See [Agent Factory](/contracts/core-contracts/agent-factory) for the Solidity interface.