@viberlabs/api-server

Express REST API server with SSE for real-time updates.

Installation

npm install @viberlabs/api-server

Usage

Start the server

import { ApiServer } from "@viberlabs/api-server";

const server = new ApiServer({
  port: 3001,
  databasePath: ".viber/state.db",
  corsOrigins: ["http://localhost:5173"],
});

server.start();

REST Endpoints

Tasks

• GET /api/tasks - List all tasks
• POST /api/tasks - Create a new task
• GET /api/tasks/:id - Get a specific task
• PATCH /api/tasks/:id - Update a task

Agents

• GET /api/agents - List all agents
• POST /api/agents/spawn - Spawn a new agent
• GET /api/agents/:id - Get agent status

Sessions

• GET /api/sessions - List sessions
• POST /api/sessions - Start a new session
• GET /api/sessions/:id - Get session details
• POST /api/sessions/:id/notes - Add a session note
• POST /api/sessions/:id/end - End a session

Workflows

• POST /api/workflow/execute - Execute a workflow

SSE Event Stream

Connect to /api/events/stream for real-time updates:

const eventSource = new EventSource("http://localhost:3001/api/events/stream");

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log("Event:", data.type, data.timestamp);
};

Event types:

• task.created - New task created
• task.updated - Task updated
• agent.spawned - Agent spawned
• agent.completed - Agent completed
• session.started - Session started
• session.ended - Session ended
• workflow.started - Workflow started
• workflow.completed - Workflow completed

License

MIT