API Reference

# Development
http://localhost:3001

# Production (Convex)
https://your-project.convex.cloud

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://your-project.convex.cloud/tick

{
  "success": true,
  "data": { ... }
}

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}

curl https://your-project.convex.cloud/health

{
  "status": "ok",
  "model": "anthropic/claude-3.5-sonnet",
  "lastTick": 1706400000000,
  "uptime": 86400
}

curl https://your-project.convex.cloud/state

{
  "mood": "contemplative",
  "health": 78,
  "routine": "day",
  "volatility": 0.32,
  "summary": "Analyzing market trends...",
  "updatedAt": 1706400000000
}

curl -X POST https://your-project.convex.cloud/tick \
  -H "Authorization: Bearer YOUR_TICK_TOKEN"

{
  "success": true,
  "mood": "expressive",
  "health": 80,
  "summary": "Interesting developments in the market...",
  "duration": 2340
}

curl "https://your-project.convex.cloud/memories?type=episodic&limit=10"

{
  "memories": [
    {
      "_id": "abc123",
      "type": "episodic",
      "content": "Observed unusual trading volume in ETH",
      "importance": 0.75,
      "createdAt": 1706400000000
    }
  ],
  "total": 1523
}

import { useQuery } from "convex/react";
import { api } from "./convex/_generated/api";

// React component
function AgentStatus() {
  // Auto-updates when state changes
  const state = useQuery(api.state.get);

  return (
    <div>
      <p>Mood: {state?.mood}</p>
      <p>Health: {state?.health}</p>
    </div>
  );
}