Chat API

{
  "messages": [
    {
      "role": "user",
      "content": "I need a task management system"
    }
  ],
  "chatId": "chat_xyz", // Optional, creates new if not provided
  "model": "anthropic/claude-3.5-sonnet", // Optional
  "temperature": 0.3, // Optional
  "enableDSL": true // Optional, default true
}

data: {"type": "text", "content": "I'll help you build"}

data: {"type": "dsl", "content": {"entities": {...}}}

data: {"type": "phase", "content": "clarifying"}

data: {"type": "done", "content": ""}

const response = await fetch('/api/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    messages: [{
      role: 'user',
      content: 'I need a blog with posts, authors, and comments'
    }]
  })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  
  const chunk = decoder.decode(value);
  const lines = chunk.split('\n');
  
  for (const line of lines) {
    if (line.startsWith('data: ')) {
      const data = JSON.parse(line.slice(6));
      
      switch(data.type) {
        case 'text':
          console.log('AI:', data.content);
          break;
        case 'dsl':
          console.log('DSL Update:', data.content);
          break;
        case 'phase':
          console.log('Phase:', data.content);
          break;
      }
    }
  }
}

{
  "type": "dsl",
  "content": {
    "entities": {
      "User": {
        "fields": {
          "id": { "type": "uuid", "required": true },
          "email": { "type": "string", "required": true, "unique": true },
          "name": { "type": "string", "required": true },
          "role": { "type": "enum", "values": ["admin", "author", "reader"] }
        }
      },
      "Post": {
        "fields": {
          "id": { "type": "uuid", "required": true },
          "title": { "type": "string", "required": true },
          "slug": { "type": "string", "required": true, "unique": true },
          "content": { "type": "text", "required": true },
          "excerpt": { "type": "text", "required": false },
          "authorId": { "type": "uuid", "required": true },
          "status": { "type": "enum", "values": ["draft", "published", "archived"] },
          "publishedAt": { "type": "datetime", "required": false }
        }
      },
      "Comment": {
        "fields": {
          "id": { "type": "uuid", "required": true },
          "content": { "type": "text", "required": true },
          "postId": { "type": "uuid", "required": true },
          "authorId": { "type": "uuid", "required": true },
          "approved": { "type": "boolean", "required": true, "default": false }
        }
      },
      "Tag": {
        "fields": {
          "id": { "type": "uuid", "required": true },
          "name": { "type": "string", "required": true, "unique": true },
          "slug": { "type": "string", "required": true, "unique": true }
        }
      }
    },
    "relationships": [
      { "from": "Post", "to": "User", "type": "many-to-one", "name": "author" },
      { "from": "Comment", "to": "Post", "type": "many-to-one" },
      { "from": "Comment", "to": "User", "type": "many-to-one", "name": "author" },
      { "from": "Post", "to": "Tag", "type": "many-to-many" }
    ],
    "phase": "proposing",
    "readiness": 65,
    "confidence": 0.85
  }
}

GET /api/chat/chat_xyz/stream

// Rate Limited
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please wait 60 seconds.",
    "retryAfter": 60
  }
}

// Invalid Model
{
  "error": {
    "code": "INVALID_MODEL",
    "message": "Model 'gpt-5' is not available",
    "availableModels": ["claude-3.5-sonnet", "gpt-4-turbo"]
  }
}

// OpenRouter API Error
{
  "error": {
    "code": "LLM_ERROR",
    "message": "Failed to connect to LLM service",
    "details": "Check your OPENROUTER_API_KEY"
  }
}

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

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: 'message',
    content: 'Create a task management system'
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Received:', data);
};