# 1. Create your account at https://executor.one/dashboard
#    You'll receive an API key: exo_...

# 2. Send your first goal
$ curl -X POST https://executor.one/api/goals \
  -H "Authorization: Bearer exo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "My first goal",
    "semanticPath": ["echo hello executor.one"]
  }'

{"id":"9fdc5d64-fe1f-40e3-9782-8267d515305b"}

# 3. Check status
$ curl https://executor.one/api/goals/9fdc5d64-... \
  -H "Authorization: Bearer exo_YOUR_KEY"

{
  "state": "completed",
  "progress": 1,
  "tasksTotal": 1,
  "tasksCompleted": 1
}

const ws = new WebSocket('wss://executor.one/ws');

// Authenticate on connect
ws.onopen = () => {
  ws.send(JSON.stringify({ type: 'auth', token: 'exo_YOUR_KEY' }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log(data.type, data.timestamp);
};

// Events received:
// { type: "connected", timestamp: "..." }           — on connect
// { type: "executor.booted", timestamp: "..." }      — boot complete
// { type: "goal.created", timestamp: "..." }         — new goal
// { type: "goal.completed", timestamp: "..." }       — goal done
// { type: "correction.applied", timestamp: "..." }   — error self-corrected
// { type: "executor.error", timestamp: "..." }       — error occurred
// { type: "executor.shutting_down", timestamp: "..." } — shutdown

$ curl -X POST https://executor.one/api/goals \
  -H "Authorization: Bearer exo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Build and deploy the frontend",
    "semanticPath": [
      "cd /app && git pull origin main",
      "npm ci",
      "npm run build",
      "pm2 restart frontend"
    ],
    "priority": "high"
  }'

$ curl -X POST https://executor.one/api/goals \
  -H "Authorization: Bearer exo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Create a Node.js Express API with /users CRUD endpoints, PostgreSQL database, and Docker Compose setup",
    "priority": "normal"
  }'

# LLM decomposes into ~10 tasks: mkdir, create package.json,
# write server.js, create docker-compose.yml, write Dockerfile,
# docker compose up, npm install, npm start, curl verify

# Store
$ curl -X POST https://executor.one/api/memory \
  -H "Authorization: Bearer exo_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "key": "db-credentials", "value": {"host":"db.internal","port":5432}, "tags": ["infra","secrets"], "importance": 1.0 }'

# Crystallize (permanent, never garbage collected)
$ curl -X POST https://executor.one/api/memory/db-credentials/crystallize \
  -H "Authorization: Bearer exo_YOUR_KEY"

# Recall
$ curl "https://executor.one/api/memory?query=db&tags=infra" \
  -H "Authorization: Bearer exo_YOUR_KEY"

# Delete
$ curl -X DELETE https://executor.one/api/memory/db-credentials \
  -H "Authorization: Bearer exo_YOUR_KEY"

import WebSocket from 'ws';

const ws = new WebSocket('wss://executor.one/ws');

ws.on('open', () => {
  ws.send(JSON.stringify({ type: 'auth', token: 'exo_YOUR_KEY' }));
});

ws.on('message', (data) => {
  const event = JSON.parse(data.toString());

  if (event.type === 'goal.completed') {
    console.log('Goal done!', event.timestamp);
    // Trigger next step in your pipeline
  }

  if (event.type === 'executor.error') {
    // Send alert to Slack, PagerDuty, etc.
  }
});

#!/bin/bash
# Send goal and wait for completion

API_KEY="exo_YOUR_KEY"

GOAL_ID=$(curl -s -X POST https://executor.one/api/goals \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"Deploy to production","semanticPath":["git pull","npm ci","npm run build","pm2 restart all"]}' \
  | jq -r .id)

while true; do
  STATE=$(curl -s https://executor.one/api/goals/$GOAL_ID \
    -H "Authorization: Bearer $API_KEY" | jq -r .state)
  case $STATE in
    completed) echo "Deploy successful"; exit 0 ;;
    failed)    echo "Deploy failed";     exit 1 ;;
    *)         sleep 2 ;;
  esac
done