API Reference

GET    /api/projects          — List all projects
POST   /api/projects          — Create a new project
GET    /api/projects/:id      — Get project details
DELETE /api/projects/:id      — Delete a project

GET    /api/projects/:id/files           — List project files
GET    /api/projects/:id/files/:path     — Read a file
PUT    /api/projects/:id/files/:path     — Write a file
DELETE /api/projects/:id/files/:path     — Delete a file

POST   /api/chat               — Send a chat message
POST   /api/chat/stream         — Stream a chat response

const ws = new WebSocket('ws://localhost:3000/api/ws');

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  switch (data.type) {
    case 'chat_chunk':    // Streaming AI response chunk
    case 'chat_complete': // Full response completed
    case 'file_change':   // File was modified by AI
    case 'terminal':      // Terminal output
    case 'error':         // Error occurred
  }
};

// Synchronous (wait for complete response)
const response = await fetch('/api/chat', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'Create a React component',
    provider: 'openai',
    model: 'gpt-4o',
    projectId: 'my-project',
  }),
});

// Streaming (receive chunks as they arrive)
const response = await fetch('/api/chat/stream', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    prompt: 'Create a React component',
    provider: 'openai',
    model: 'gpt-4o',
    projectId: 'my-project',
  }),
});

const reader = response.body.getReader();
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  processChunk(value);
}

// Subscribe to project events
amplify.on('project:created', (project) => { ... });
amplify.on('project:deleted', (projectId) => { ... });

// Subscribe to file events
amplify.on('file:created', (file) => { ... });
amplify.on('file:modified', (file) => { ... });
amplify.on('file:deleted', (filePath) => { ... });

// Subscribe to AI events
amplify.on('chat:started', (conversation) => { ... });
amplify.on('chat:completed', (response) => { ... });
amplify.on('chat:error', (error) => { ... });