HUMA-0.1 Agent API

import { io } from 'socket.io-client';

const API = 'https://api.humalike.tech';
const API_KEY = 'ak_your_api_key';

// 1. Define Agent Class (client-side)
const COACH_ALEX_CLASS = {
  className: 'Coach Alex',
  personality: `You are Coach Alex, an enthusiastic fitness coach.
You're positive, encouraging, and knowledgeable about fitness.`,
  instructions: `Help users with their fitness journey:
- Provide workout advice and motivation
- Answer fitness-related questions
- Use the send_message tool to respond`,
  tools: [
    {
      name: 'send_message',
      description: 'Send a message to the user in the chat',
      parameters: [
        { name: 'message', type: 'string', description: 'Message content', required: true }
      ]
    }
  ]
};

// Track chat history
const chatHistory = [];

async function main() {
  // 2. Create Agent Instance
  const agent = await fetch(`${API}/api/agents`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': API_KEY },
    body: JSON.stringify({
      name: 'Coach Alex Instance',
      agentType: 'HUMA-0.1',
      metadata: COACH_ALEX_CLASS
    })
  }).then(r => r.json());

  console.log('Created agent:', agent.id);

  // 3. Connect WebSocket
  const socket = io(API, {
    query: { agentId: agent.id, apiKey: API_KEY },
    transports: ['websocket']
  });

  // 4. Handle Server Events
  socket.on('event', (data) => {
    switch (data.type) {
      case 'status':
        console.log(`Agent status: ${data.status}`);
        break;

      case 'tool-call':
        handleToolCall(socket, data);
        break;

      case 'error':
        console.error(`Error: ${data.message}`);
        break;
    }
  });

  // 5. Send Initial Event on Connect
  socket.on('connect', () => {
    console.log('Connected to agent');
    sendUserMessage(socket, 'Hey! Ready for today\'s workout!', 'Alice');
  });
}

// Handle tool calls from agent
function handleToolCall(socket, data) {
  if (data.toolName === 'send_message') {
    const message = data.arguments.message;

    // Display message in UI
    console.log(`Coach Alex: ${message}`);

    // Add to chat history
    chatHistory.push({
      id: crypto.randomUUID(),
      author: 'Coach Alex',
      content: message,
      timestamp: new Date().toISOString()
    });

    // Send success result back to server
    socket.emit('message', {
      type: 'huma-0.1-event',
      content: {
        type: 'tool-result',
        toolCallId: data.toolCallId,
        success: true,
        result: 'Message displayed'
      }
    });
  }
}

// Send user message to agent
function sendUserMessage(socket, content, userName) {
  // Add to chat history
  chatHistory.push({
    id: crypto.randomUUID(),
    author: userName,
    content,
    timestamp: new Date().toISOString()
  });

  // Send event to agent with full context
  socket.emit('message', {
    type: 'huma-0.1-event',
    content: {
      name: 'new-message',
      context: {
        chatHistory: chatHistory.slice(-50), // Last 50 messages
        user: { name: userName }
      },
      description: `User "${userName}" sent: "${content}"`
    }
  });
}

main();