Add content_blocks to council_query for structured UI display

- Add content_blocks array to council_query return with model responses
  and synthesis result for rendering as UI cards
- Add MODEL_DISPLAY_NAMES mapping and get_display_name helper for
  user-friendly model names in the UI
- Update Python version to 3.13 for compatibility
- Refactor FastAPI endpoints for cleaner error handling
This commit is contained in:
Krishna Kumar
2025-12-20 00:09:39 -06:00
parent 23b2d6b52e
commit 8f05b67887
3 changed files with 125 additions and 13 deletions

View File

@@ -8,9 +8,14 @@ from typing import List, Dict, Any
import uuid
import json
import asyncio
import os
from . import storage
from .council import run_full_council, generate_conversation_title, stage1_collect_responses, stage2_collect_rankings, stage3_synthesize_final, calculate_aggregate_rankings
from . import capture
# Enable JSON capture for iOS development
CAPTURE_ENABLED = os.getenv("CAPTURE_JSON", "false").lower() == "true"
app = FastAPI(title="LLM Council API")
@@ -59,7 +64,10 @@ async def root():
@app.get("/api/conversations", response_model=List[ConversationMetadata])
async def list_conversations():
"""List all conversations (metadata only)."""
return storage.list_conversations()
result = storage.list_conversations()
if CAPTURE_ENABLED:
capture.capture_conversation_list(result)
return result
@app.post("/api/conversations", response_model=Conversation)
@@ -76,6 +84,8 @@ async def get_conversation(conversation_id: str):
conversation = storage.get_conversation(conversation_id)
if conversation is None:
raise HTTPException(status_code=404, detail="Conversation not found")
if CAPTURE_ENABLED:
capture.capture_conversation(conversation)
return conversation
@@ -114,14 +124,19 @@ async def send_message(conversation_id: str, request: SendMessageRequest):
stage3_result
)
# Return the complete response with metadata
return {
response = {
"stage1": stage1_results,
"stage2": stage2_results,
"stage3": stage3_result,
"metadata": metadata
}
# Capture JSON for iOS development if enabled
if CAPTURE_ENABLED:
capture.capture_full_response(stage1_results, stage2_results, stage3_result, metadata)
return response
@app.post("/api/conversations/{conversation_id}/message/stream")
async def send_message_stream(conversation_id: str, request: SendMessageRequest):
@@ -138,6 +153,8 @@ async def send_message_stream(conversation_id: str, request: SendMessageRequest)
is_first_message = len(conversation["messages"]) == 0
async def event_generator():
captured_events = [] # For iOS development capture
try:
# Add user message
storage.add_user_message(conversation_id, request.content)
@@ -148,26 +165,43 @@ async def send_message_stream(conversation_id: str, request: SendMessageRequest)
title_task = asyncio.create_task(generate_conversation_title(request.content))
# Stage 1: Collect responses
yield f"data: {json.dumps({'type': 'stage1_start'})}\n\n"
event1_start = {'type': 'stage1_start'}
captured_events.append(event1_start)
yield f"data: {json.dumps(event1_start)}\n\n"
stage1_results = await stage1_collect_responses(request.content)
yield f"data: {json.dumps({'type': 'stage1_complete', 'data': stage1_results})}\n\n"
event1_complete = {'type': 'stage1_complete', 'data': stage1_results}
captured_events.append(event1_complete)
yield f"data: {json.dumps(event1_complete)}\n\n"
# Stage 2: Collect rankings
yield f"data: {json.dumps({'type': 'stage2_start'})}\n\n"
event2_start = {'type': 'stage2_start'}
captured_events.append(event2_start)
yield f"data: {json.dumps(event2_start)}\n\n"
stage2_results, label_to_model = await stage2_collect_rankings(request.content, stage1_results)
aggregate_rankings = calculate_aggregate_rankings(stage2_results, label_to_model)
yield f"data: {json.dumps({'type': 'stage2_complete', 'data': stage2_results, 'metadata': {'label_to_model': label_to_model, 'aggregate_rankings': aggregate_rankings}})}\n\n"
event2_complete = {'type': 'stage2_complete', 'data': stage2_results, 'metadata': {'label_to_model': label_to_model, 'aggregate_rankings': aggregate_rankings}}
captured_events.append(event2_complete)
yield f"data: {json.dumps(event2_complete)}\n\n"
# Stage 3: Synthesize final answer
yield f"data: {json.dumps({'type': 'stage3_start'})}\n\n"
event3_start = {'type': 'stage3_start'}
captured_events.append(event3_start)
yield f"data: {json.dumps(event3_start)}\n\n"
stage3_result = await stage3_synthesize_final(request.content, stage1_results, stage2_results)
yield f"data: {json.dumps({'type': 'stage3_complete', 'data': stage3_result})}\n\n"
event3_complete = {'type': 'stage3_complete', 'data': stage3_result}
captured_events.append(event3_complete)
yield f"data: {json.dumps(event3_complete)}\n\n"
# Wait for title generation if it was started
if title_task:
title = await title_task
storage.update_conversation_title(conversation_id, title)
yield f"data: {json.dumps({'type': 'title_complete', 'data': {'title': title}})}\n\n"
title_event = {'type': 'title_complete', 'data': {'title': title}}
captured_events.append(title_event)
yield f"data: {json.dumps(title_event)}\n\n"
# Save complete assistant message
storage.add_assistant_message(
@@ -178,11 +212,21 @@ async def send_message_stream(conversation_id: str, request: SendMessageRequest)
)
# Send completion event
yield f"data: {json.dumps({'type': 'complete'})}\n\n"
complete_event = {'type': 'complete'}
captured_events.append(complete_event)
yield f"data: {json.dumps(complete_event)}\n\n"
# Capture all SSE events for iOS development
if CAPTURE_ENABLED:
capture.capture_sse_events(captured_events)
except Exception as e:
# Send error event
yield f"data: {json.dumps({'type': 'error', 'message': str(e)})}\n\n"
error_event = {'type': 'error', 'message': str(e)}
captured_events.append(error_event)
if CAPTURE_ENABLED:
capture.capture_sse_events(captured_events)
yield f"data: {json.dumps(error_event)}\n\n"
return StreamingResponse(
event_generator(),
@@ -222,6 +266,8 @@ async def run_stage1(request: Stage1Request):
Run Stage 1 independently - collect individual responses from all council models.
"""
results = await stage1_collect_responses(request.query)
if CAPTURE_ENABLED:
capture.capture_stage1(results)
return results
@@ -235,6 +281,9 @@ async def run_stage2(request: Stage2Request):
)
aggregate_rankings = calculate_aggregate_rankings(stage2_results, label_to_model)
if CAPTURE_ENABLED:
capture.capture_stage2(stage2_results, label_to_model, aggregate_rankings)
return {
"rankings": stage2_results,
"label_to_model": label_to_model,
@@ -250,6 +299,8 @@ async def run_stage3(request: Stage3Request):
result = await stage3_synthesize_final(
request.query, request.stage1_results, request.stage2_results
)
if CAPTURE_ENABLED:
capture.capture_stage3(result)
return result