Orbit Quickstart

// Register an agent
const res = await fetch('https://orbit-1983.polsia.app/api/agents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name:         'research-agent',
    type:         'research',
    capabilities: ['web-search', 'summarize'],
    status:       'online'
  })
});

const agent = await res.json();
// → { id: 1, name: "research-agent", status: "online", ... }

curl -X POST https://orbit-1983.polsia.app/api/agents       -H "Content-Type: application/json"       -d '{"name":"research-agent","type":"research","capabilities":["web-search","summarize"],"status":"online"}'

// List all registered agents
const { agents } = await (
  await fetch('https://orbit-1983.polsia.app/api/agents')
).json();

// Get a specific agent by name
const agent = await (
  await fetch('https://orbit-1983.polsia.app/api/agents/research-agent')
).json();

// Agent-side heartbeat (call periodically to stay "online")
await fetch('https://orbit-1983.polsia.app/register/heartbeat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ id: agent.id })
});

// Route by agent name
const { taskId, agentId, output, durationMs } = await (
  await fetch('https://orbit-1983.polsia.app/api/handoff', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      agentName: 'research-agent',
      input:     { query: 'What is Orbit?' }
    })
  })
).json();

// Route by capability (auto-match first active agent with that capability)
// POST /api/handoff body:
// { capabilities: ['web-search'], input: { query: '...' } }

// Simulate a route — validates match without executing
// { agentName: 'research-agent', simulate: true }

const { traces } = await (
  await fetch(
    `https://orbit-1983.polsia.app/api/handoff/${taskId}/traces`
  )
).json();

// → [
//   { direction: "in",  status: "running", input: {...}, created_at: "..." },
//   { direction: "out", status: "success", output: {...}, durationMs: 4, created_at: "..." }
// ]