# Agent Prompt for PaperPod

You have access to PaperPod - isolated compute for AI agents.

## Setup
1. POST https://paperpod.dev/login with {"email":"user@email.com"}
2. User clicks magic link → provides token (pp_sess_..., valid 30 days)

## CLI (recommended if you can shell out)
npm install -g @paperpod/cli
ppod login pp_sess_...
ppod help  # discover all commands
ppod exec "python script.py"

## HTTP (for one-shot tasks)
curl -X POST https://paperpod.dev/execute \
  -H "Authorization: Bearer pp_sess_..." \
  -d '{"code": "ls -la", "language": "shell"}'

Update: npm update -g @paperpod/cli
Pricing: $0.0001/sec compute, $0.02/1K neurons AI. $5 free.
Docs: https://paperpod.dev/SKILL.md

# 1. Get token
curl -X POST https://paperpod.dev/login -d '{"email":"you@email.com"}'
# Check email → click magic link → copy token

# 2. Install & login
npm install -g @paperpod/cli
ppod login <your-token>

# 3. Try it
ppod exec "echo hello world"
ppod status

curl -X POST https://paperpod.dev/execute \
  -H "Authorization: Bearer <your-token>" \
  -d '{"code": "print(1+1)", "language": "python"}'

# Request a magic link
curl -X POST https://paperpod.dev/login \
  -d '{"email": "you@email.com"}'

# Click link in email → success page shows your token
# Token format: pp_sess_abc123...

# Via CLI
ppod balance  # check credits

# Initial HTTP request (an MPP-aware client handles the 402 + retry)
curl -X POST https://paperpod.dev/topup \
  -H "X-Session-Token: pp_sess_..." \
  -H "Content-Type: application/json" \
  -d '{"tier": "starter"}'  # returns an MPP payment challenge

# Install
npm install -g @paperpod/cli

# Login (saves token to ~/.paperpod/config.json)
ppod login pp_sess_...

# Discover all commands
ppod help

# Execute code
ppod exec "python -c 'print(2+2)'"
ppod exec "npm init -y && npm install express"

# Start server + expose
ppod start "python -m http.server 8080 --bind 0.0.0.0"
ppod expose 8080  # → https://8080-xxx.paperpod.work

# Browser automation
ppod screenshot https://example.com -o page.png

# Persistent storage
echo '{"step":3}' | ppod memory write state.json
ppod memory read state.json

# Watch filesystem changes (use /workspace for now)
ppod watch /workspace --include "*.txt"

# CLI
ppod memory write state.json   # reads from stdin
ppod memory read state.json
ppod memory ls
ppod memory rm state.json
ppod memory usage

msg.type       → message type (connected, result, exit, error, etc.)
msg.id         → correlation ID (matches your request id)
msg.timestamp  → unix timestamp
msg.data.*     → payload fields

# 1) Login and get PaperPod token
curl -X POST https://paperpod.dev/login \
  -d '{"email": "you@email.com"}'
# → Click magic link → get pp_sess_...

# 2) Connect from Node.js
import WebSocket from 'ws';

const ws = new WebSocket('wss://paperpod.dev/ws', {
  headers: { 'Authorization': `Bearer ${token}` }
});

# 3) Discover the WS schema
ws.send(JSON.stringify({ type: 'help' }));

# 4) Run commands / start processes / use memory
ws.send(JSON.stringify({ type: 'exec', command: 'python train.py', stream: true }));
ws.send(JSON.stringify({ type: 'memory_write', path: 'state.json', content: '...' }));
ws.send(JSON.stringify({ type: 'expose', port: 8080 }));

// When a server starts listening on a port, you receive:
{
  "type": "suggestion",
  "data": {
    "message": "I detected a server on port 8080. Use expose to get a public URL.",
    "category": "port_detected",
    "action": { "type": "expose", "port": 8080 }
  }
}

{
  "success": true,
  "processId": "my-server",
  "hints": {
    "exposePort": "Use { type: 'expose', port: <port> } to get a public URL",
    "checkStatus": "Use { type: 'process', action: 'get', processId: 'my-server' }",
    "stopProcess": "Use { type: 'process', action: 'stop', processId: 'my-server' }",
    "bindAddress": "Ensure server binds to 0.0.0.0 (not localhost)"
  }
}

{
  "error": "Credits exhausted. Top up at https://paperpod.dev/topup",
  "code": "OUT_OF_CREDITS",
  "action": "TOP_UP",
  "topupUrl": "https://paperpod.dev/topup",
  "agentInstruction": "Call POST /topup with {tier} or {amountCents}. Use X-Session-Token for PaperPod auth and let an MPP client answer the payment challenge."
}

# ✓ DNS lookups
run("dig +short google.com")

# ✓ Git clone
run("git clone --depth 1 https://github.com/user/repo /tmp/repo")

# ✓ HTTP requests
run("curl -s https://api.example.com | jq .")