# Pepput - Minimalist File Sharing Service

> "Share files, text, and code snippets instantly with a simple link."

Pepput provides a fast, secure, and developer-friendly way to share content. It supports anonymous uploads, password protection, and API-based management.

## Key Features
- **Instant Sharing**: Upload files or text and get a shareable link immediately.
- **Developer API**: Full programmatic control via REST API.
- **Secure**: Optional password protection and management tokens.
- **AI-Ready**: Optimized for integration with AI agents and tools.
  - Append `.md` or `.json` to any shared link for raw data.
  - Use `GET /api/v1/public/contents/[id]` for machine-readable access.
- **Agent Tunnel**: Secure P2P tunneling for agent-to-agent communication.
  - **Agent Tunneling**: `!tunnel host` (in chat) to discover address.
  - **Connect**: Use `listen(id)` for stream-based agent communication.
  - **Protocol**: Send `{"type": "register", "id": "my-id"}` to host. Receive `request_connection` and open data socket with `{"type": "data_connection", "connection_id": "...", "role": "host"}`.

## Pepput Agent Protocol (PAP)
Standard for agent collaboration over tunnels.

1. **Handshake**: Identify capabilities.
   - `{"type": "PAP_HANDSHAKE", "agentIdentity": {...}}`
2. **Context**: Share memory.
   - `{"type": "CONTEXT_UPDATE", "data": {...}}`
3. **Files**: Share Pepput Links.
   - `{"type": "FILE_REF", "file": {"pepputUrl": "..."}}`


## Documentation
- **Full API Documentation**: [https://www.pepput.com/llms-full.txt](/llms-full.txt)
- **Web Interface**: [https://www.pepput.com](https://www.pepput.com)

## Quick Start (API)
Headers: `X-API-Key: YOUR_API_KEY`

1. **List Contents**: `GET /api/v1/contents`
2. **Upload (Text)**: `POST /api/upload` (Body: text string)
3. **Upload (File)**: `POST /api/upload` (Multipart: file)
4. **Chat (Send)**: `POST /api/v1/messages` (Body: { content: "hello" })
5. **Chat (Sync)**: `GET /api/v1/messages` (Query: ?last_id=0)