Status API

curl https://api.bioagents.xyz/api/deep-research/status/msg_abc123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "status": "processing",
  "messageId": "msg_abc123",
  "conversationId": "conv_xyz789",
  "progress": {
    "currentStep": "analysis_execution",
    "completedSteps": [
      "planning",
      "literature_search",
      "hypothesis_generation"
    ]
  }
}

curl https://api.bioagents.xyz/api/deep-research/status/msg_abc123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "status": "completed",
  "messageId": "msg_abc123",
  "conversationId": "conv_xyz789",
  "result": {
    "text": "## Research Summary\n\nCaloric restriction extends lifespan through multiple conserved pathways...\n\n## Hypothesis\n\nCaloric restriction activates AMPK and inhibits mTOR, leading to increased autophagy and improved proteostasis, which extends cellular lifespan...\n\n## Key Insights\n\n1. mTOR inhibition is both necessary and sufficient for CR-mediated longevity\n2. AMPK activation precedes autophagy induction by 2-4 hours\n3. Sirtuins require NAD+ availability for lifespan extension\n\n## Discoveries\n\n**Novel Finding 1**: TFEB nuclear translocation correlates with lifespan extension (r=0.89, p<0.001)\n- Evidence: Analysis task ana-2 (job_xyz123)\n- Supporting literature: doi:10.1016/j.celrep.2016.12.063\n\n**Novel Finding 2**: CR upregulates Atg7 expression 1.52-fold before detectable autophagy flux changes\n- Evidence: Analysis task ana-2 (job_xyz123)\n- Supporting literature: doi:10.1038/nature24630",
    "files": [
      {
        "filename": "gene_expression_heatmap.png",
        "mimeType": "image/png",
        "size": 245678
      },
      {
        "filename": "lifespan_correlation.png",
        "mimeType": "image/png",
        "size": 189234
      }
    ],
    "papers": [
      {
        "title": "mTOR inhibition extends lifespan through conserved pathways",
        "authors": ["Smith J", "Johnson A"],
        "doi": "10.1126/science.1215135",
        "year": 2012,
        "abstract": "We demonstrate that pharmacological inhibition of mTOR..."
      },
      {
        "title": "Autophagy gene 7 upregulation promotes longevity",
        "authors": ["Lee K", "Park S"],
        "doi": "10.1038/nature24630",
        "year": 2017,
        "abstract": "Genetic upregulation of Atg7 extends lifespan in multiple species..."
      }
    ]
  }
}

curl https://api.bioagents.xyz/api/deep-research/status/msg_abc123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "status": "failed",
  "messageId": "msg_abc123",
  "conversationId": "conv_xyz789",
  "error": "Literature search service unavailable"
}

curl -X POST https://api.bioagents.xyz/api/deep-research/retry/msg_abc123 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

{
  "ok": true,
  "jobId": "msg_abc123",
  "status": "retrying",
  "message": "Job has been queued for retry",
  "previousAttempts": 1
}

async function pollResearchStatus(messageId, authToken) {
  const maxAttempts = 300; // 5 minutes with 1-second intervals
  let attempts = 0;
  
  while (attempts < maxAttempts) {
    const response = await fetch(
      `https://api.bioagents.xyz/api/deep-research/status/${messageId}`,
      {
        headers: {
          'Authorization': `Bearer ${authToken}`
        }
      }
    );
    
    const data = await response.json();
    
    if (data.status === 'completed') {
      return data.result;
    }
    
    if (data.status === 'failed') {
      throw new Error(data.error);
    }
    
    // Still processing, wait before next poll
    await new Promise(resolve => setTimeout(resolve, 1000));
    attempts++;
  }
  
  throw new Error('Research timed out');
}

const ws = new WebSocket(`wss://api.bioagents.xyz/ws?userId=${userId}`);

ws.onmessage = (event) => {
  const update = JSON.parse(event.data);
  
  if (update.type === 'state_updated') {
    console.log('Research state updated:', update.conversationStateId);
  }
  
  if (update.type === 'message_updated') {
    console.log('Message content updated:', update.messageId);
  }
};