"""FastAPI server for the multi-agent content generation system.
All agents run on port 7860 with different API endpoints:
- /api/agents/showrunner - Generate episode directive
- /api/agents/story-editor - Generate episode outline
- /api/agents/cultural-consultant - Review for cultural accuracy
- /api/agents/lead-writer - Write episode script
- /api/agents/dialogue-specialist - Polish dialogue
- /api/agents/comedy-writer - Add humor and punch-ups
- /api/agents/proofreader - Final quality control
- /api/pipeline - Execute full pipeline
"""
import logging
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from typing import Optional
from orchestrator import PipelineOrchestrator
from config import settings
from instructor import Instructor
from fastapi.responses import HTMLResponse
import requests
# Configure logging
logging.basicConfig(
level=settings.log_level,
format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
)
logger = logging.getLogger(__name__)
# Initialize FastAPI app
app = FastAPI(
title="Multi-Agent Content Generation System",
description="API-first system for collaborative content generation using poolside/laguna-m.1:free. All agents on port 7860.",
version="1.0.0",
)
# Initialize orchestrator and instructor
orchestrator = PipelineOrchestrator()
instructor = Instructor()
latest_briefs = {} # Store by session or just global for now
# Request/Response Models
class PipelineRequest(BaseModel):
"""Request model for pipeline execution."""
user_brief: str
season_arc_document: str
character_bible: str
world_building_document: str
character_voice_guide: str
style_guide: str
continuity_log: str
hook_brief: Optional[str] = None
class PipelineResponse(BaseModel):
"""Response model for pipeline execution."""
run_id: str
status: str
final_output: dict
hf_output_url: str
hf_metadata_url: str
class HealthResponse(BaseModel):
"""Health check response."""
status: str
run_id: str
port: int
# ─────────────────────────────────────────────────────────────────────────────
# HEALTH & STATUS ENDPOINTS
# ─────────────────────────────────────────────────────────────────────────────
@app.get("/health", response_model=HealthResponse)
async def health_check():
"""Health check endpoint."""
return {
"status": "healthy",
"run_id": orchestrator.run_id,
"port": settings.port,
}
@app.get("/", response_class=HTMLResponse)
async def root():
"""Root endpoint redirects to Instructor UI."""
return await get_instructor_ui()
# ─────────────────────────────────────────────────────────────────────────────
# PIPELINE ENDPOINTS (Port 7860)
# ─────────────────────────────────────────────────────────────────────────────
@app.post("/api/pipeline/execute", response_model=PipelineResponse)
async def execute_pipeline(request: PipelineRequest):
"""Execute the full content generation pipeline.
Endpoint: POST /api/pipeline/execute
Port: 7860
Args:
request: Pipeline execution request with all required inputs
Returns:
Pipeline execution result with final output and URLs
"""
try:
logger.info(f"[PIPELINE] Received execution request: {request.user_brief[:50]}...")
result = orchestrator.execute_pipeline(
user_brief=request.user_brief,
season_arc_document=request.season_arc_document,
character_bible=request.character_bible,
world_building_document=request.world_building_document,
character_voice_guide=request.character_voice_guide,
style_guide=request.style_guide,
continuity_log=request.continuity_log,
hook_brief=request.hook_brief,
)
return {
"run_id": result["run_id"],
"status": result["status"],
"final_output": result["final_output"],
"hf_output_url": result["hf_output_url"],
"hf_metadata_url": result["hf_metadata_url"],
}
except Exception as e:
logger.error(f"[PIPELINE] Execution error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.get("/api/pipeline/status/{run_id}")
async def get_pipeline_status(run_id: str):
"""Get the status of a pipeline run.
Endpoint: GET /api/pipeline/status/{run_id}
Port: 7860
Args:
run_id: The run ID to check
Returns:
Pipeline status and state
"""
try:
if run_id == orchestrator.run_id:
return {
"run_id": run_id,
"status": orchestrator.pipeline_state.get("status", "unknown"),
"pipeline_state": orchestrator.pipeline_state,
}
else:
raise HTTPException(status_code=404, detail="Run ID not found")
except Exception as e:
raise HTTPException(status_code=500, detail=str(e))
# ─────────────────────────────────────────────────────────────────────────────
# INSTRUCTOR ENDPOINTS (Port 7860)
# ─────────────────────────────────────────────────────────────────────────────
@app.get("/instructor", response_class=HTMLResponse)
async def get_instructor_ui():
"""Instructor UI for brief approval."""
html_content = """
Instructor Module - Brief Approval
Instructor Module
Instructor is fusing trends into a story...
Proposed Storytelling Brief
LLM Generated
"""
return HTMLResponse(content=html_content)
@app.post("/api/instructor/generate")
async def api_generate_brief(request: dict):
"""API endpoint to generate a brief from trending topics."""
try:
topics = request.get("topics", [])
if not topics:
raise HTTPException(status_code=400, detail="No topics provided")
logger.info(f"[INSTRUCTOR] Generating brief for topics: {topics}")
brief = instructor.generate_brief(topics)
# Store the brief for approval (using a simple global for this demo)
global latest_briefs
latest_briefs["current"] = brief
return {"status": "success", "brief": brief}
except Exception as e:
logger.error(f"[INSTRUCTOR] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/instructor/approve")
async def api_approve_brief(request: dict):
"""API endpoint to approve and send the brief to the orchestrator."""
if not request.get("approved"):
return {"status": "discarded"}
global latest_briefs
brief = latest_briefs.get("current")
if not brief:
raise HTTPException(status_code=400, detail="No brief available to approve")
try:
logger.info("[INSTRUCTOR] Brief approved, executing pipeline")
# We can call the orchestrator directly since we're in the same process
result = orchestrator.execute_pipeline(
user_brief=brief["user_brief"],
season_arc_document=brief["season_arc_document"],
character_bible=brief["character_bible"],
world_building_document=brief["world_building_document"],
character_voice_guide=brief["character_voice_guide"],
style_guide=brief["style_guide"],
continuity_log=brief["continuity_log"],
hook_brief=brief.get("hook_brief"),
)
return {
"status": "success",
"run_id": result["run_id"],
"hf_output_url": result["hf_output_url"]
}
except Exception as e:
logger.error(f"[INSTRUCTOR] Pipeline error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
# ─────────────────────────────────────────────────────────────────────────────
# AGENT ENDPOINTS (Port 7860)
# ─────────────────────────────────────────────────────────────────────────────
@app.post("/api/agents/showrunner")
async def showrunner_endpoint(request: dict):
"""Showrunner Agent: Generate episode directive.
Endpoint: POST /api/agents/showrunner
Port: 7860
Input:
- user_brief: Initial user brief
- season_arc_document: Season context
- character_bible: Character definitions
Output:
- episode_directive: Generated directive
- story_premise: Story premise
- tone_brief: Tone brief
- character_focus_notes: Character notes
"""
try:
logger.info("[SHOWRUNNER] Processing directive generation")
result = orchestrator.showrunner.generate_directive(request)
return result
except Exception as e:
logger.error(f"[SHOWRUNNER] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/story-editor")
async def story_editor_endpoint(request: dict):
"""Story Editor Agent: Generate episode outline.
Endpoint: POST /api/agents/story-editor
Port: 7860
Input:
- episode_directive: From Showrunner
- series_continuity_log: Continuity reference
- character_list: Valid character names
Output:
- episode_outline: Generated outline
- act_structure: Act breakdown
- story_notes_for_writers: Story notes
"""
try:
logger.info("[STORY-EDITOR] Processing outline generation")
result = orchestrator.story_editor.generate_outline(request)
return result
except Exception as e:
logger.error(f"[STORY-EDITOR] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/cultural-consultant")
async def cultural_consultant_endpoint(request: dict):
"""Cultural Consultant Agent: Review for cultural accuracy.
Endpoint: POST /api/agents/cultural-consultant
Port: 7860
Input:
- episode_outline: From Story Editor
- world_building_document: World context
- character_list: Valid character names
Output:
- cultural_accuracy_notes: Accuracy notes
- flagged_inaccuracies: Issues found
- approved_touchpoints: Approved elements
- reference_suggestions: Suggestions
"""
try:
logger.info("[CULTURAL-CONSULTANT] Processing cultural review")
result = orchestrator.cultural_consultant.review_outline(request)
return result
except Exception as e:
logger.error(f"[CULTURAL-CONSULTANT] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/lead-writer")
async def lead_writer_endpoint(request: dict):
"""Lead Writer Agent: Write episode script.
Endpoint: POST /api/agents/lead-writer
Port: 7860
Input:
- approved_outline: From Story Editor
- cultural_consultant_notes: From Cultural Consultant
- character_voice_guide: Character voice definitions
- character_list: Valid character names
- story_premise: Story premise from Showrunner
Output:
- full_episode_first_draft: Complete script
- scene_descriptions: Scene descriptions
- dialogue: Dialogue content
- stage_directions: Stage directions
"""
try:
logger.info("[LEAD-WRITER] Processing script writing")
result = orchestrator.lead_writer.write_script(request)
return result
except Exception as e:
logger.error(f"[LEAD-WRITER] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/dialogue-specialist")
async def dialogue_specialist_endpoint(request: dict):
"""Dialogue Specialist Agent: Polish dialogue.
Endpoint: POST /api/agents/dialogue-specialist
Port: 7860
Input:
- first_draft_script: From Lead Writer
- character_voice_guide: Character voice definitions
- character_list: Valid character names
- dialect_slang_reference: Reference material
Output:
- dialogue_polished_script: Polished script
- voice_consistency_notes: Voice notes
"""
try:
logger.info("[DIALOGUE-SPECIALIST] Processing dialogue polish")
result = orchestrator.dialogue_specialist.polish_dialogue(request)
return result
except Exception as e:
logger.error(f"[DIALOGUE-SPECIALIST] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/comedy-writer")
async def comedy_writer_endpoint(request: dict):
"""Comedy Writer Agent: Add humor and punch-ups.
Endpoint: POST /api/agents/comedy-writer
Port: 7860
Input:
- dialogue_polished_script: From Dialogue Specialist
- hook_brief_from_showrunner: Hook context
- character_list: Valid character names
- tone_brief: Tone reference
Output:
- comedy_sharpened_script: Comedy-enhanced script
- punch_up_notes: Notes on changes
- hook_rewrite_for_opening: Opening hook
"""
try:
logger.info("[COMEDY-WRITER] Processing humor addition")
result = orchestrator.comedy_writer.add_humor(request)
return result
except Exception as e:
logger.error(f"[COMEDY-WRITER] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
@app.post("/api/agents/proofreader")
async def proofreader_endpoint(request: dict):
"""Proofreader Agent: Final quality control.
Endpoint: POST /api/agents/proofreader
Port: 7860
Input:
- comedy_sharpened_script: From Comedy Writer
- style_guide: Style reference
- continuity_log: Continuity tracking
- character_list: Valid character names
Output:
- final_locked_script: Final script
- qc_report: Quality control report
- continuity_log_update: Updated continuity log
"""
try:
logger.info("[PROOFREADER] Processing final QC")
result = orchestrator.proofreader.final_qc(request)
return result
except Exception as e:
logger.error(f"[PROOFREADER] Error: {str(e)}")
raise HTTPException(status_code=500, detail=str(e))
# ─────────────────────────────────────────────────────────────────────────────
# SERVER STARTUP
# ─────────────────────────────────────────────────────────────────────────────
if __name__ == "__main__":
import uvicorn
logger.info(f"Starting Multi-Agent System on port {settings.port}")
logger.info("All agents available at http://localhost:7860/api/agents/*")
logger.info("Full pipeline available at http://localhost:7860/api/pipeline/execute")
logger.info("API documentation at http://localhost:7860/docs")
uvicorn.run(
app,
host=settings.host,
port=settings.port,
log_level=settings.log_level.lower(),
)